ドキュメントExperience Cloud KCS

AEM環境でパッケージのインストールに失敗する

最終更新日： 2026年7月16日

パッケージに不変パス、無効なZIP構造、インストールフック、または影響を受けるSDK バージョンが含まれている場合、AEM パッケージのインストールが失敗します。 インストールエラーを診断し、適切な解決手順に従ってパッケージを正常にインストールします。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • Adobe Developer App Builder

問題/症状

  • jcr_rootが見つからないため、アーカイブが有効なコンテンツパッケージではないことを示すアップロード中のエラー。
  • インストール中にパッケージ検証エラーが発生しました。
  • パッケージに不変のリポジトリパスが含まれているため、インストールがブロックされました。
  • すべてのパッケージ内の埋め込みパッケージは、自動的にインストールされません。
  • 無効なパッケージ名が原因で発生するパッケージダウンロードのエラー。
  • インストールフッククラスの欠落に関連するインストールエラー。

原因

パッケージ構造が無効な場合、パッケージに不変のリポジトリパスが含まれている場合、パッケージ名にサポートされていない文字が含まれている場合、インストールフックがサポートされていない場所で使用されている場合、またはデプロイメントがリグレッションの影響を受けるSDK バージョンに依存している場合に、インストールエラーが発生します。

解決策 resolution

この問題を解決するには、次の手順に従います。

  1. パッケージマネージャーのメッセージまたはログを確認して、インストールエラーを特定します。
  2. パッケージがコンテンツパッケージとして認識されない場合は、META-INFとjcr_rootがZIP ファイルの最上位に存在することを確認します。 必要に応じて、パッケージを再作成します。
  3. パッケージに不変のリポジトリパスが含まれている場合は、パッケージマネージャーから直接インストールするのではなく、適切なデプロイメントパイプラインを介してコードをデプロイします。
  4. 埋め込みパッケージが自動的にインストールされない場合は、SDK バージョンを確認し、リグレッション修正を含むSDK バージョンにアップグレードします。
  5. インストールフックをサポートしていない環境にデプロイする場合は、インストールフックを削除します。 サポートされている環境の場合、必要なすべての依存関係がインストールされていることを確認します。
  6. パッケージ名を更新して、サポートされていない文字を削除し、パッケージを再ビルドしてから再デプロイします。
  7. インストールエラーが表示されなくなり、埋め込みパッケージが該当する場合に正しくインストールされていることを確認して、インストールを検証します。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles