文档Experience Cloud KCS

AEM Cloud Manager：开发管道生成失败，显示“项目必须使用Java 21或更高版本编译”

最近更新： 2026年7月24日

本文介绍了如何解决Adobe Experience Manager Cloud Manager管道中由Java版本要求导致的生成失败。

描述 description

环境

Adobe Experience Manager (AEM) Cloud Manager（所有版本）

问题/症状

在Cloud Manager中运行非生产开发管道时，构建会失败，并出现Maven Enforcer插件错误，需要Java 21或更高版本。 构建日志中显示以下错误：

11:28:07,666 [ main]  [ WARNING]  Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion failed with message:
Project must be compiled with Java 21 or higher
  • 管道构建停止，并跳过后续模块。

根本原因

生成失败，因为项目需要Java 21或更高版本，但管道未配置为通过.cloudmanager/java-version文件使用正确的Java版本。

解决方法 resolution

按照以下步骤解决问题

  1. 验证您的存储库是否包含根级别的文件.cloudmanager/java-version。
  2. 打开.cloudmanager/java-version文件并确保它仅包含值21（无额外的空格或字符）。
  3. 如果文件不存在，请在存储库的根目录下创建该文件并添加值21。
  4. 提交更改并将其推送到存储库。
  5. 重新运行Cloud Manager管道，以确认构建成功完成。

相关阅读

[设置Maven JDK版本]（https://experienceleague.adobe.com/zh-hans/docs/experience-manager-cloud-service/content/implementing/using-cloud-manager/create-application-project/build-environment-details#： :text=设置%20the%20Maven%20JDK，Java%2017%20is%20used）

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