Spring Boot 3.x로의 업그레이드는 많은 개발자에게 새로운 기능과 향상된 성능을 제공하지만, 이를 실행하는 과정에서 몇 가지 문제가 발생할 수 있습니다. 특히, Java 버전과 관련된 호환성 문제로 인해 IntelliJ에서 Spring Boot 3.x 프로젝트가 제대로 실행되지 않는 경우가 많습니다. 여기서는 이러한 문제의 원인과 해결 방법을 자세히 설명합니다.
1. Java 버전 확인
Spring Boot 3.x 버전부터는 Java 17 이상이 필수입니다. 따라서, 사용하고 있는 Java 버전이 17 이상인지 확인하는 것이 중요합니다. 이를 확인하려면 커맨드 프롬프트(또는 터미널)에서 다음 명령어를 실행하세요:
java -version이 명령어를 실행하면 현재 설치된 Java 버전이 표시됩니다. 만약 17 이하의 버전이 설치되어 있다면, Java 17 이상을 설치해야 합니다.
2. build.gradle 파일 설정
다음 단계는 프로젝트의 build.gradle 파일을 확인하는 것입니다. 이 파일에서 sourceCompatibility 속성이 17로 설정되어 있는지 확인합니다. 설정 예시는 다음과 같습니다:
sourceCompatibility = '17'이 설정이 누락되었다면 추가해 주세요.
3. IntelliJ 설정 변경
IntelliJ에서 프로젝트를 올바른 Java 버전으로 실행할 수 있도록 설정을 변경해야 합니다.
3-1. Gradle 설정 확인
- Preferences/Settings 메뉴를 엽니다.
- Build, Execution, Deployment -> Build Tools -> Gradle로 이동합니다.
- 여기서 Gradle의 JVM이 Java 17 이상으로 설정되어 있는지 확인합니다.
3-2. Project SDK 설정
- File -> Project Structure로 이동합니다.
- Project 탭에서 SDK가 Java 17 이상으로 설정되어 있는지 확인합니다.
- Modules에서 각 모듈의 Language level도 확인하고, 필요시 조정합니다.
4. Gradle Refresh
모든 설정을 변경한 후에는 IntelliJ에서 Gradle을 다시 리프레시해야 합니다. 이를 통해 변경된 설정이 적용되며, 정상적으로 빌드가 진행되는지 확인할 수 있습니다.
이러한 단계를 수행한 후에도 여전히 문제가 발생한다면, Gradle 캐시를 삭제하거나, 프로젝트를 클린 빌드하는 것도 고려해 볼 수 있습니다.
Spring Boot 3.x 실행 오류
오랜만에 제대로 Spring Boot를 공부하기 위해 실행환경 구축 중 오류가 발생했다ㅠ예전에 Spring Boot에 대해 알아보기 위해 간단하게 구현한 적이 있었다.그 당시에는 2.x 버전으로 만들었는데 지원
velog.io
Spring Boot 3.x를 IntelliJ에서 성공적으로 실행하기 위해서는 Java 17 이상의 설치와 함께 Gradle 및 IntelliJ 설정이 올바르게 구성되어야 합니다. 이러한 기본적인 확인 및 설정 과정을 통해 문제를 해결할 수 있으며, 이를 통해 새로운 기능과 향상된 성능을 즐길 수 있습니다.