DocumentaçãoKCS da Experience Cloud

Problemas de descontinuação do Java 8 e Java 11 durante a migração para o Java 21 no AEMaaCS

Última atualização: 15 de julho de 2026

O Adobe Experience Manager (AEM) as a Cloud Service não é mais compatível com Java 8 ou Java 11 no tempo de execução e requer migração para Java 21. Esse problema ocorre quando versões Java de tempo de compilação, versões Java de tempo de execução, dependências de terceiros ou linhas do tempo de migração criam preocupações de compatibilidade e incerteza sobre as ações necessárias. Para resolver o problema, verifique o tempo de execução, valide a compatibilidade e atualize as builds.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomas

  • Os avisos de compilação do Cloud Manager indicam o uso de APIs Java obsoletas.
  • O ambiente executa o Java 21 no tempo de execução, enquanto a build ainda usa o Java 11.
  • As equipes não têm certeza se as builds do Java 11 permanecem compatíveis após a implantação do tempo de execução do Java 21.
  • As notificações do Centro de ações fazem referência aos requisitos de desativação ou migração do Java.
  • As versões Java do tempo de execução e de tempo de compilação parecem inconsistentes entre os ambientes.

Causa raiz

O problema ocorre porque o AEM as a Cloud Service atualiza os ambientes de tempo de execução para o Java 21, enquanto os projetos do cliente podem continuar usando o Java 11 para processos de build. O Java do tempo de execução é gerenciado pela Adobe, enquanto o Java do tempo de compilação é controlado pela configuração do projeto. A compreensão incorreta dessa separação, juntamente com APIs obsoletas e incompatibilidades de dependência, causa preocupações com a migração e problemas de validação de build.

Resolução resolution

Siga estas etapas para validar o uso do tempo de execução do Java e preparar o aplicativo para compatibilidade com o Java 21:

  1. Verifique a versão do Java de tempo de execução abrindo o Developer Console no Cloud Manager e revisando a versão do Java relatada.
  2. Registre a versão do Java de tempo de execução por meio de um componente OSGi personalizado, registrando o valor de System.getProperty("java.version") quando a versão de tempo de execução não estiver visível no Developer Console.
  3. Revise o arquivo .cloudmanager/java-version e determine se o projeto é compilado com Java 11, 17 ou 21.
  4. Valide a compatibilidade do Java 21 garantindo que o ambiente esteja no AEM versão 17098 ou posterior, executando o SDK local com Java 21, implantando o aplicativo localmente e verificando se não há problemas de carregamento de classe ou dependência.
  5. Crie uma ramificação de desenvolvimento que defina .cloudmanager/java-version como 21 e execute um pipeline de desenvolvimento para validar o comportamento do aplicativo no Java 21.
  6. Revise o uso da API descontinuada quando as notificações do Centro de ações forem exibidas e atualize o código que faz referência a pacotes descontinuados ou removidos, como APIs removidas do Sling, Felix ou Jetty.
  7. Atualize a versão da compilação para o Java 21 criando ou modificando o arquivo .cloudmanager/java-version com 21 e executando um pipeline de não produção assim que a validação de compatibilidade for bem-sucedida.
  8. Revise qualquer email de notificação de migração do Java 21 e atualize bibliotecas ou dependências não compatíveis identificadas na análise de dependência. Por exemplo, substitua ou atualize versões não compatíveis de bibliotecas, como Groovy ou Logback, quando identificadas.
  9. Valide a resolução confirmando se os relatórios de tempo de execução do Java 21, as builds do Cloud Manager foram bem-sucedidas, os avisos de desativação não são mais exibidos e os testes funcionais foram bem-sucedidos.

Quando escalonar

  • O Developer Console permanece inacessível após a validação das permissões.
  • O aplicativo continua a mostrar incompatibilidades de dependência após a validação do Java 21.
  • As builds do Cloud Manager falham após atualizar a versão de build para o Java 21.
  • Dependências sem suporte permanecem sem solução após a análise e a correção da migração.

Leitura relacionada

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