IntelliJ에서 Spring Boot 3 버전 실행이 안되는 경우

 
안녕하세요 dev-길길IT입니다.
 
java 기반의 web을 구축할 때 많이 사용하는 프레임워크 중 하나가 바로 spring boot입니다. spring 대비 설정도 간단하고, 시스템 구성보다는 코드에 더 집중할 수 있기 때문에 많이 각광을 받고 있는데요. 저도 api 서버라던지, 간단한 SPA를 구축할 때 주로 사용하고는 합니다.
 
오랜만에 새로운 spring boot 프로젝트를 구축하려고 하는데, 현재 기준으로 가장 최신 버전이 3.4 버전대인데요. 셋팅을 하고 실행을 시켜보려고 하니 Dependency requires at least JVM runtime version 17. 이라는 오류가 뜨면서 build에 실패하더라구요. 이게 왜 나오는지, 어떻게 해결하는지를 간단하게 알려드리겠습니다.
 

※ 목차

0. Dependency requires at least JVM runtime version 17 의미
1. System java 버전 확인
2. IntelliJ 셋팅 변경

 
 

IntelliJ에서 Spring Boot 3 버전 실행이 안되는 경우

---

 

0. Dependency requires at least JVM runtime version 17 의미

 

dependency requires at least JVM runtime version 17

 
 
 
직역하면 의존성은 적어도 JVM runtime 17 버전을 필요로 한다는 의미입니다. spring boot 3버전부터는 java의 버전이 높아졌는데요. 최소 17 버전 이상을 사용해야 한다는 것이죠. 현재 가장 최신 버전의 자바 jdk는 2023년 3월에 release된 22버전입니다. 만약 상황이 맞지 않아 17버전보다 아래의 자바를 사용해야 한다면, spring boot 버전을 2로 낮춰야 합니다.

---

 

1. system java 버전 확인

 
그렇다면 왜 spring boot 3 버전 실행이 안되는지 한 번 system의 java 버전을 확인해보겠습니다. 먼저 실행창을 띄워주는데요. 키보드의 windows 버튼과 R키를 동시에 누르면 뜹니다. 여기에 cmd라고 명령 프롬프트를 띄워주는 명령어를 입력하고 확인을 눌러주겠습니다.
 

 
그런 다음 명령 프롬프트 창에 java -version이라고 입력하고 엔터를 쳐줍니다. 그러면 현재 시스템에 설치된 자바 버전이 표시되는데요. 저는 현재 1.8 버전이 설치되어 있네요. 그래서 인식이 되지 않았던 것입니다. 
 

---

 
 

2. intelliJ 셋팅 변경

 
그러면 이제 intelliJ에서 셋팅을 변경해 줄 차례입니다. java의 버전을 별도로 올려주면 되는데요. 먼저 intelliJ - File - Project Structure 메뉴로 이동해줍니다.

 
그런 다음 Project Settings에서 Project 탭으로 이동을 해주고요. 여기에 보시면 현재 기본 SDK 항목이 있습니다. 여기에서 JDK 1.8 이상의 java를 선택해주시면 됩니다. 별도로 설치를 해도 되고, intelliJ에 보면 자체적으로 설치를 할 수 있는 기능도 있습니다. 그렇게 JDK 22를 설치한 다음 설정해주면 됩니다.
 

 
 또 다른 설정으로는 File - Settings에 가시면 있는데요. Build, Execution, Deployment > Build Tools에 가셔서 현재 사용하는 Type에 맞게 Maven이나 Gradle을 선택하고 들어가봅니다. 저는 Gradle을 사용하고 잇는데요. 아래쪽에 보면 Gradle JVM이라는 영역에서도 JDK 버전을 선택할 수 있게 되어 있습니다. 현재 저는 system의 jdk 버전인 1.8이 선택되어 있네요.

 
그래서 이 항목을 좀 전에 설치했던 project SDK인 openjdk-22로 변경하고 Apply를 해주었습니다.
 

 
 
이제 다시 실행해보면 정상적으로 실행이 되는 것을 확인하실 수 있습니다

---

 
 
 

마무리

오늘은 IntelliJ에서 Spring Boot 3 버전 실행이 안되는 경우를 알아보았습니다. 결국 핵심은 각 프레임워크나 dependency들의 버전이 맞지 않아서 발생하는 현상입니다. 그럴 때는 이렇게 least version을 체크해서 설정을 진행해주면 정상적으로 사용이 가능할 것입니다.
 
도움이 되시기를 바라며, 오늘도 읽어주셔서 감사합니다.