ドキュメントExperience Cloud KCS

AEM Cloud Manager: 「プロジェクトはJava 21以降でコンパイルする必要があります」で開発パイプラインのビルドが失敗する

最終更新日： 2026年7月24日

この記事では、Java バージョン要件に起因するAdobe Experience Manager Cloud Manager パイプラインのビルドエラーを解決する方法について説明します。

説明 description

環境

Adobe Experience Manager（AEM）Cloud Manager（すべてのバージョン）

問題/症状

Cloud Managerで実稼動以外の開発パイプラインを実行すると、ビルドが失敗し、Java 21以降を必要とするMaven enforcer プラグインエラーが発生します。 ビルドログに次のエラーが表示されます。

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/ja/docs/experience-manager-cloud-service/content/implementing/using-cloud-manager/create-application-project/build-environment-details#: :text=Set%20the%20Maven%20JDK,Java%2017%20is%20used）

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