설명서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 집행기 플러그인 오류와 함께 빌드가 실패합니다. 빌드 로그에 다음 오류가 표시됩니다.

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/ko/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