DocumentationExperience Cloud KCS

L’installation du package échoue dans les environnements AEM

Dernière mise à jour : 16 juillet 2026

L’installation du package AEM échoue lorsque les packages incluent des chemins non modifiables, une structure ZIP non valide, des hooks d’installation ou des versions SDK affectées. Diagnostiquez l’erreur d’installation et suivez les étapes de résolution appropriées pour installer le package.

Description description

Environnement

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

Problème/Symptômes

  • Erreur lors du chargement indiquant que l’archive n’est pas un package de contenu valide, car jcr_root est manquant.
  • Erreurs de validation du package lors de l’installation.
  • Installation bloquée car le package contient des chemins d’accès de référentiel non modifiables.
  • Les packages intégrés dans un package all ne s’installent pas automatiquement.
  • Les échecs de téléchargement de package sont dus à des noms de package non valides.
  • Échecs d’installation liés à des classes de hook d’installation manquantes.

Cause

Les échecs d’installation se produisent lorsque la structure du package n’est pas valide, que le package inclut des chemins de référentiel non modifiables, que les noms de package contiennent des caractères non pris en charge, que les hooks d’installation sont utilisés lorsqu’ils ne sont pas pris en charge ou que le déploiement repose sur une version de SDK affectée par une régression.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Identifiez l’erreur d’installation en examinant le ou les journaux du gestionnaire de packages.
  2. Si le package n’est pas reconnu comme package de contenu, vérifiez que META-INF et jcr_root existent au niveau supérieur du fichier ZIP. Recréez le package si nécessaire.
  3. Si le package contient des chemins de référentiel non modifiables, déployez le code par le biais du pipeline de déploiement approprié au lieu de l’installer directement via le gestionnaire de packages.
  4. Si les packages incorporés ne s’installent pas automatiquement, vérifiez la version de SDK et effectuez une mise à niveau vers une version de SDK qui inclut le correctif de régression.
  5. Supprimez les hooks d’installation lors d’un déploiement dans des environnements qui ne les prennent pas en charge. Pour les environnements pris en charge, vérifiez que toutes les dépendances requises sont installées.
  6. Mettez à jour les noms de package pour supprimer les caractères non pris en charge et recréez le package avant de le déployer à nouveau.
  7. Validez l’installation en confirmant que les erreurs d’installation ne s’affichent plus et que les packages incorporés s’installent correctement, le cas échéant.

Lecture connexe

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