文件Experience Cloud KCS

AEM Cloud Manager： Dev管道建置失敗，顯示「專案必須使用Java 21或更新版本編譯」

最後更新： 2026年7月24日

本文說明如何解決Adobe Experience Manager Cloud Manager管道中由Java版本要求所導致的建置失敗。

說明 description

環境

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

問題/症狀

在Cloud Manager中執行非生產開發管道時，組建失敗並出現Maven強制器外掛程式錯誤，需要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-hant/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