Problèmes d’obsolescence de Java 8 et Java 11 lors de la migration vers Java 21 dans AEMaaCS

Dernière mise à jour : 15 juillet 2026

Adobe Experience Manager (AEM) as a Cloud Service ne prend plus en charge Java 8 ou Java 11 au moment de l’exécution et nécessite la migration vers Java 21. Ce problème se produit lorsque les versions Java au moment de la création, les versions Java d’exécution, les dépendances tierces ou les délais de migration créent des problèmes de compatibilité et une incertitude quant aux actions requises. Pour résoudre ce problème, vérifiez l’exécution, validez la compatibilité et mettez à jour les versions.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problème/Symptômes

Les avis de création de Cloud Manager indiquent l’utilisation d’API Java obsolètes.
L’environnement exécute Java 21 au moment de l’exécution, tandis que la version utilise toujours Java 11.
Les équipes ne savent pas si les versions Java 11 restent prises en charge après le déploiement d’exécution de Java 21.
Les notifications d’Actions Center font référence aux exigences d’obsolescence ou de migration de Java.
Les versions Java d’exécution et de création semblent incohérentes entre les environnements.

Cause première

Le problème se produit, car AEM as a Cloud Service met à niveau les environnements d’exécution vers Java 21 tandis que les projets clients peuvent continuer à utiliser Java 11 pour les processus de création. L’exécution de Java est gérée par Adobe, tandis que Java au moment de la création est contrôlé par la configuration du projet. Une mauvaise compréhension de cette séparation, ainsi que des API obsolètes et des incompatibilités de dépendance, entraîne des problèmes de migration et de validation des builds.

Résolution resolution

Pour valider l’utilisation de l’exécution Java et préparer l’application à la compatibilité Java 21, procédez comme suit :

Vérifiez la version Java d’exécution en ouvrant le Developer Console à partir de Cloud Manager et en examinant la version Java signalée.
Enregistrez la version Java d’exécution par le biais d’un composant OSGi personnalisé en enregistrant la valeur de System.getProperty("java.version") lorsque la version d’exécution n’est pas visible dans le Developer Console.
Consultez le fichier .cloudmanager/java-version et déterminez si le projet est créé avec Java 11, 17 ou 21.
Validez la compatibilité Java 21 en vous assurant que l’environnement se trouve dans la version AEM 17098 ou ultérieure, en exécutant le SDK local avec Java 21, en déployant l’application localement et en vérifiant qu’aucun problème de chargement de classe ou de dépendance ne se produit.
Créez une branche de développement qui définit .cloudmanager/java-version sur 21 et exécutez un pipeline de développement pour valider le comportement de l’application sous Java 21.
Passez en revue l’utilisation obsolète de l’API lorsque les notifications d’Actions Center s’affichent et mettez à jour le code qui fait référence à des packages obsolètes ou supprimés tels que les API Sling, Felix ou Jetty supprimées.
Mettez à jour la version de build vers Java 21 en créant ou en modifiant le fichier .cloudmanager/java-version avec 21 et en exécutant un pipeline hors production une fois la validation de compatibilité réussie.
Consultez les e-mails de notification de migration Java 21 et mettez à jour les bibliothèques non prises en charge ou les dépendances identifiées dans l’analyse des dépendances. Par exemple, remplacez ou mettez à niveau des versions non prises en charge de bibliothèques telles que Groovy ou Logback lorsqu’elles sont identifiées.
Validez la résolution en confirmant que les rapports d’exécution Java 21, les versions Cloud Manager réussissent, les avis d’obsolescence n’apparaissent plus et les tests fonctionnels réussissent.

Quand réaffecter

Le Developer Console reste inaccessible une fois les autorisations validées.
L’application continue à présenter des incompatibilités de dépendance après la validation de Java 21.
Les builds Cloud Manager échouent après la mise à jour de la version de build vers Java 21.
Les dépendances non prises en charge ne sont toujours pas résolues après l’analyse et la correction de la migration.

Lecture connexe

recommendation-more-help

experience-cloud-kcs-help-kbarticles