새 SpringBoot 프로젝트를 생성하는 도중 첫 빌드부터 실패하며 위와 같은 오류를 만났다.

오류도 딸랑 한줄이다.
해석 :
원인: org/gradle/internal/Enterprise/impl/GradleEnterprisePluginServices는 최신 버전의 Java Runtime(클래스 파일 버전 61.0)에 의해 컴파일되었으며, 이 버전의 Java Runtime은 클래스 파일 버전을 최대 55.0까지만 인식합니다
보면 현재 JRE(JDK) 의 버전이 낮아 충돌이 일어났다는 메세지다.
이 에러를 그대로 구글에 쳐보거나 ai 에게 도움을 구하면, 이전 작업은 61버전(=java17) 에 의해 컴파일되었으나 현재 JRE 는 55버전(=java11)까지만 지원하기 때문에 실패한다는 이야기.
따라서 프로젝트 sdk 를 17로 통합시켜 주어야 한다.(당연하고 일반적인 해결책)
비슷한 jdk 버전 충돌 문제는 아래 방법으로 해결 가능하다)
1. 프로젝트 설정 -> 빌드,실행,배포 -> 빌드 도구 -> Gradle(내 프로젝트의 경우) -> Gradle JVM 변경 (원하는 sdk 로 변경)
※ 같은 설정에서 [다음을 사용하여 빌드 및 테스트 실행] 옵션을 바꿔보는 것이 해결책이 될 수도 있다.
[디폴트]Gradle -> itellij IDEA
2. 프로젝트 구조 -> 프로젝트 -> SDK 변경(원하는 sdk로 변경)
3. 시스템 환경변수 변경
시스템 환경변수를 바꿀 수도 있지만, intellij IDEA 는 프로젝트별 jdk 를 지정할 수 있으므로 중요하지 않다.
4. 파일 -> 캐시 무효화 및 다시 시작 : 한번 해서 안되면 모든 체크박스 체크하고 다시 해보는것도 방법이다.
여기까지는 일반적으로 jdk 버전 문제를 해결하기 위해 많이 알려진 방법이다.
다음부터는 해결을 위해 시도한 방법들이다
1. 프로젝트 루트 경로에 gradle.properties 파일 생성 후 jdk 경로 추가
org.gradle.java.home="원하는 jdk 경로"
위 한 줄을 추가하고 저장하고 다시 실행
2. .gradle 폴더에서 caches/daemon 폴더 삭제
gradle 실행에 관련된 캐시를 완전히 삭제하는 방법이다.
3. 프로젝트 내의 .idea 폴더 완전 삭제
4. IDEA 런타임 버전 변경(비추)
인텔리제이 IDEA 가 부팅될 때 사용하는 jdk 버전이 있다(는걸 처음 알았다).
도움말->정보(A) 를 누르면 런타임 버전정보를 확인할 수 있고,
수정하려면 도움말->액션 찾기-> "Choose Boot Java Runtime for the IDE" 치기
그러면 현재 런타임 버전정보와 함께 이를 수정할 수도 있는데 웬만하면 건드리지 않는 것을 추천
건드리고 다시시작했다가 critical Error 뜨면서 인텔리제이 부팅이 아예 안됐다.(인텔리제이를 아예 사용 못하는 상황)
C:\Users\[사용자명]\AppData\Roaming\JetBrains\IntelliJIdea[버전]\idea64.exe.jdk 파일 수정해서 해결했다.
위 파일 열면 수정한 버전정보를 다시 이전 버전으로 편집할 수 있다.
...
왜 안되는지 정말 이유를 못찾겠을 때, 프로젝트 세팅할 당시 SpringBoot 버전을 건드리지 않은 것을 확인했다. 제일 최신 버전인 4.0.0 버전이 자동으로 선택되어 있었다.
혹시나 해서 마지막으로 모든 구성 동일하게 하고 SpringBoot 버전만 3.5.8로 새 프로젝트를 생성했는데, 시원하게 빌드에 성공했다.
또 혹시나 해서 같은 구성으로 4.0.0 버전으로 다시 프로젝트를 만들어 봤는데, 같은 에러가 발생했다.
왜 이런 문제가 있는건가 싶어서 SpringBoot 4의 시스템 요구사항을 확인해 봤는데,
Java 17~25까지 호환
maven 3.6.3 이상
gradle 8.14 이상
정도였다.
대체 뭐때문에 발생한 에러였는지 알게 되면 내용을 추가할 예정이다.
'Study' 카테고리의 다른 글
| 로드밸런싱 기본 (0) | 2025.12.25 |
|---|---|
| TCP/UDP (0) | 2025.12.18 |
| OSI 7 계층 (0) | 2025.12.18 |
| Https와 TLS/SSL (0) | 2025.12.17 |
| Ollama 를 사용한 피드백 어시스트 만들기 (LLM 커스터마이징) (0) | 2025.12.16 |