[트러블슈팅] ,/gradlew clean build 빌드 실패 (Java 버전 문제)

 

상황 설명

 

IntelliJ 실행 버튼으로 하는 경우는 잘 작동하는데

 

 

 

하지만 `./gradlew clean build`  명령어는 자꾸 실패했다.

 

gradlew 프로젝트 gradle 버전으로 실행
clean 전 빌드 캐시가 문제를 일으킬 수 있으므로, 클린 상태로 빌드 할 때 사용
build 컴파일+테스트+패키징 (자바 컴파일, jar 생성 등등..

 

 

이유는 IntelliJ 는 내부 JDK 로 실행돼서 잘 작동했던 것 같고 (Setting gradle 17 로 잘 세팅되어있었음..!)

Docker 사용을 위해서 ./gradlew build 방식으로 명령어를 했던 것인데 .. 왜 작동되지 않았을까!

 

 

 

 

해결 방법

 

Spring Boot 3.4.4 기반 프로젝트에서 `./gradlew clean build` 명령어 실행 시 다음과 같은 상황 발생

> Could not resolve org.springframework.boot:spring-boot-gradle-plugin:3.4.4.
  ...
  > Dependency requires at least JVM runtime version 17. This build uses a Java 11 JVM.

 

기존에 프로젝트를 Java 11로 진행하다가 새로운 프로젝트를 17로 하려니 오류가 터짐

버전이 맞지 않다고 어찌고저찌

기존 java 11이 남아있었나보다.  싶어서 변경!

 

 

 

1) 환경변수 값 변경 11 -> 17 ❌

 

jdk-17 설치해주고

https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html

 

시스템 환경변수에 들어가서 기존 java 11 을 java 17 로 변경해줬다. 

 

 

`./gradlew clean build` 

버전 변경 후  다시 시도해봤는데도 실패함 ...

 

 

 

2) 재부팅 ❌

`./gradlew clean build` 

재부팅 하고 실행해보는데도 실패

 

 

 

 

3) `./gradlew clean build --warning-mode all` 으로 성공 ✅

이후 `./gradlew clean build` 도 정상 작동하기 시작함 !

 

 

 

 

에러 원인 추측 

 

1. Gradle 데몬이 자바 11로 실행된 상태였음

Gradle은 데몬(gradle daemon)을 백그라운드에서 실행시켜서 빌드 속도를 빠르게 해줌.
문제는 이 데몬이 처음 실행됐을 때의 Java 환경을 기억한다는 점임.
JAVA_HOME을 바꿔도, 이미 실행 중인 데몬은 계속 자바 11을 사용했을 수 있음.
그래서 자바 버전을 변경한 이후에도 빌드가 실패했음.

 

 

2. --warning-mode all → Gradle 내부 상태 리셋 유도

--warning-mode all 옵션을 주면, Gradle이 전체 스크립트를 다시 분석함.
이 과정에서 의존성 재다운로드, 캐시 무효화, 데몬 재시작 같은 부수적인 동작이 발생할 수 있음.
이로 인해 새로운 Java 17 환경이 적용됐을 가능성이 높음.