Spring Boot 3.x 이상 버전에서 프로젝트 빌드에 실패하는 경우 (Mac OS 기준)

이번 포스팅에서는 IntelliJ를 이용해 Spring Boot 3.x 버전 이상의 프로젝트를 생성하는 과정에서 발생한 문제에 대해 해결한 부분을 공유하고자 합니다.

 

 

1. 문제 상황

(1) Spring Boot 3.x 이상의 신규 프로젝트 생성 과정에서 문제가 발생했습니다.

생성 과정 시 발생한 오류 메시지

 

 

 

 

2. 문제 확인 

(1) 확인 시, 3.x 이상 버전부터는 Java 11을 지원하지 않고, Java 17 이상부터 지원한다고 합니다.

 

(2) 이에 따라, 기존에 설치되어 있던 Java 11 대신 새로운 Java 17을 설치하고 환경 변수 설정을 변경하게 되었습니다.

 

 

 

 

 

3. 문제 해결 진행

(1) 터미널을 열고 brew install openjdk@17 커맨드를 실행합니다.

brew install openjdk@17

Command : brew install openjdk@17

 

 

(2) 터미널에서 이에 대한 작업 상황을 알려주고 Java 17 설치가 완료됩니다.

 

 

(3) 마지막으로 vi editor를 통해 Java 환경 변수를 재설정합니다.

vi ~/.zshrc

Command : vi ~/.zshrc

 

 

(4) 아래와 같이 방금 설치한 Java 17을 기준으로 환경변수를 재설정합니다.

export JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.3/libexec/openjdk.jdk/Contents/Home
export PATH=${PATH}:$JAVA_HOME/bin

vi editor를 통해 자바 환경변수를 재설정한다.

 

 

(5) 위와 같이 환경변수를 설정해 주고 에디터를 저장하고 종료한 다음, source ~/.zshrc 커맨드로 변경사항을 적용시킵니다.

source ~/.zshrc

Command : source ~/.zshrc

 

 

(6) 이 부분까지 진행되었다면 환경변수 설정이 모두 완료되었고 성공적으로 적용되었는지 Java 버전을 확인해 보겠습니다.

 

 

 

 

 

3. Java 버전 / Spring Boot 프로젝트 생성 재확인

(1) java --version

- 확인 시 Java 버전이 17로 변경된 것을 확인할 수 있습니다.

java --version

Command : java --version

 

 

(2) IntelliJ를 실행해서 Preference(Settings) → Build, Execution, Deployment → Gradle Projects 경로에서 Gradle JVM 항목을 Java 17로 변경합니다.

17 Oracle OpenJDK version 17.0.7로 설정

 

 

(3) 설정 완료 후 프로젝트 생성 / 재빌드에 성공한 것을 확인할 수 있었습니다.

 

 

 

 

- 내용 중에서 오타 또는 잘못된 내용이 있을 시 댓글로 남겨주시면 감사하겠습니다!