Paketinstallation schlägt in AEM-Umgebungen fehl

Letzte Aktualisierung: 16. Juli 2026

Die AEM-Paketinstallation schlägt fehl, wenn Pakete unveränderliche Pfade, ungültige ZIP-Struktur, Installationshaken oder betroffene SDK-Versionen enthalten. Diagnostizieren Sie den Installationsfehler und führen Sie die entsprechenden Schritte zur Behebung aus, um das Paket erfolgreich zu installieren.

Beschreibung description

Umgebung

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

Problem/Symptome

Fehler beim Hochladen, der darauf hinweist, dass das Archiv kein gültiges Inhaltspaket ist, da jcr_root fehlt.
Paketvalidierungsfehler während der Installation.
Die Installation wurde blockiert, da das Paket unveränderliche Repository-Pfade enthält.
Eingebettete Pakete innerhalb eines Pakets werden nicht automatisch installiert.
Fehler beim Herunterladen von Paketen aufgrund ungültiger Paketnamen.
Installationsfehler aufgrund fehlender Installations-Hook-Klassen.

Ursache

Installationsfehler treten auf, wenn die Paketstruktur ungültig ist, das Paket unveränderliche Repository-Pfade enthält, Paketnamen nicht unterstützte Zeichen enthalten, Installations-Hooks dort verwendet werden, wo sie nicht unterstützt werden, oder die Bereitstellung auf einer SDK-Version beruht, die von einer Regression betroffen ist.

Lösung resolution

Gehen Sie wie folgt vor, um dieses Problem zu beheben:

Ermitteln Sie den Installationsfehler, indem Sie die Meldung oder die Protokolle des Package Managers überprüfen.
Wenn das Paket nicht als Inhaltspaket erkannt wird, überprüfen Sie, ob META-INF und jcr_root auf der obersten Ebene der ZIP-Datei vorhanden sind. Erstellen Sie das Paket bei Bedarf neu.
Wenn das Paket unveränderliche Repository-Pfade enthält, stellen Sie den Code über die entsprechende Bereitstellungs-Pipeline bereit, anstatt ihn direkt über Package Manager zu installieren.
Wenn eingebettete Pakete nicht automatisch installiert werden, überprüfen Sie die SDK-Version und aktualisieren Sie auf eine SDK-Version, die die Regressionsbehebung enthält.
Entfernen Sie Installations-Hooks bei der Bereitstellung in Umgebungen, die sie nicht unterstützen. Stellen Sie bei unterstützten Umgebungen sicher, dass alle erforderlichen Abhängigkeiten installiert sind.
Aktualisieren Sie Paketnamen, um nicht unterstützte Zeichen zu entfernen und das Paket neu zu erstellen, bevor Sie es erneut bereitstellen.
Überprüfen Sie die Installation, indem Sie bestätigen, dass Installationsfehler nicht mehr angezeigt werden und eingebettete Pakete ggf. korrekt installiert werden.