DocumentationExperience Cloud KCS

Résolution des erreurs HTTP 500 sur une seule instance de publication AEM en raison d’une incohérence du bundle OSGi

Dernière mise à jour : 18 octobre 2026

Cet article explique comment résoudre les erreurs HTTP 500 qui se produisent sur une seule instance de publication Adobe Experience Manager (AEM) lorsque les lots OSGi ne sont pas résolus et s’activent correctement suite à un redémarrage anormal ou non nettoyé.

Description description

Environnement

Déploiement de la publication multi-instance Managed Services Adobe Experience Manager (AEM) (toutes les versions prises en charge)

Problème/Symptômes

  • Une instance de publication renvoie un nombre élevé d’erreurs HTTP 500 sur plusieurs URL d’application.
  • Les autres instances de publication continuent à diffuser normalement le trafic.
  • Les journaux d’application affichent des échecs de compilation HTL/Sightly répétés, car les classes Java ne peuvent pas être résolues.
  • Les journaux de framework OSGi signalent les erreurs de résolution de lot et les dépendances non résolues pour les lots d’applications requis.

Cause

Un redémarrage anormal ou impropre laisse le framework OSGi sur l’instance de publication affectée dans un état incohérent. La résolution et l’activation des lots d’applications requis échouent. Par conséquent, les classes nécessaires à la compilation HTL ne sont pas disponibles et les requêtes aux URL d’application affectées renvoient des erreurs HTTP 500.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème.

  1. Supprimez l’instance de publication concernée de la rotation de la répartition de charge pour éviter tout autre impact sur le client.

  2. Redémarrez ou remplacez l’instance de publication concernée à l’aide d’un processus contrôlé et propre.

  3. Une fois l’instance redémarrée ou remplacée, vérifiez que tous les lots OSGi requis sont résolus et actifs :

    • Accédez à la console système d’AEM (généralement à l’adresse /system/console/bundles) et vérifiez que tous les lots sont à l’état Actif .

    • Vérifiez que le rendu des pages d’application s’effectue correctement sans erreurs de compilation.

    • Surveillez les journaux d’erreurs pour détecter toute autre erreur de résolution de lot ou de compilation HTL.

  4. À titre de mesure préventive, implémentez une vérification de disponibilité après chaque redémarrage planifié ou non planifié pour vous assurer que tous les lots sont actifs avant de remettre l’instance en service.

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