AEM サイトで、JS の使用 API の問題が原因で「予期しないエラー」が表示される

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

AEM公開サイトが断続的に停止し、「予期しないエラー」メッセージが表示される場合は、JavaScript Use API コンポーネントの問題が原因である可能性があります。ポッドを再起動してサービスを復元し、廃止されたコードを Sling モデルに置き換え、エラー処理を改善して再発を防ぎます。

説明 description

Adobe Experience Manager as a Cloud Service（AEMaaCS） - Sites

公開 web サイトで断続的なダウンタイムが発生し、多くの場合、エラーメッセージが表示されて特定のページの読み込みに失敗します。ログは、JavaScriptの API インスタンス化の問題と HTTP 500 エラーを指します。

症状は次のとおりです。

予期しないエラー。私たちはそれをインターネットに持ち込もうとしています。影響 受けるページのメッセージ。
JavaScript次のような API エラーを使用します。Identifier linkDropdownLogic.js を Use API で正しくインスタンス化できません。
無効な参照またはスクリプトロジックが原因の Sling 例外。
一部のページは読み込みに失敗し、その他のページ（ホームページなど）は正常に再読み込みされます。

停止は、カスタムファイルのJavaScript エラーが原因です。Identifier _____.js を Use API で正しくインスタンス化できません。

すべての公開ポッドに同じコードが含まれていましたが、次の理由で失敗したのは 1 つだけです。

JavaScriptの使用 API の問題を解決するには：

すべての公開ポッドを再起動して、環境を一時的に安定させます。これにより、HTTP 500 エラーがクリアされ、サイトの可用性が復元されます。
次に、インスタンス化エラーが発生するJavaScript モデルクラスを確認します。非推奨（廃止予定）のJavaScriptを置き換える API コンポーネントを Java ベースの Sling モデルと併用し、参照されているすべてのクラスに適切なアクセスメソッドがあることを確認します。
Java イテレータでの ECMAScript デストラクチャの使用を避けるために、問題のあるコードを更新します。代わりに、標準の Java イテレータパターンを使用します。不完全なコンテンツ構造を安全に管理するために、null チェックとエラー処理を追加します。
JavaScriptに try/catch ブロックを追加します。API スクリプトを使用して、コンテンツが見つからない場合に完全にエラーが発生するのを防ぎます。コンポーネントを設計して、適切にデグレードし、カスケードエラーを回避する。
最後に、コンポーネントの依存関係を確認し、ナビゲーションなどの重要な要素に対して、キャッシュされたフォールバックコンテンツの使用を検討します。外部サービスに依存するコンポーネントに回路遮断器を実装します。