[Spring/Error] could not resolve org.springframework.boot:spring-boot-gradle-plugin 3.x

1. 오류

> Could not resolve all files for configuration ':classpath'.
　> Could not resolve org.springframework.boot:spring-boot-gradle-plugin:3.1.3.
　　Required by:
　　...

• 인텔리제이(IntelliJ) 환경에서 프로젝트를 실행하자마자 만난 오류였다.

---

2. 원인

❗ 스프링 이니셜라이저(Spring Initializr): https://start.spring.io

❗ 스프링부트(Spring Boot) 3.0 이상 버전에서는 Java 17을 필요로 한다.

• 스프링 이니셜라이저(Spring Initializr)에서 선택했던 Spring Boot/Java 버전간 호환성의 문제였다.

스프링 이니셜라이저(Spring Initializr) 사용 예시 이미지

---

3. 해결

3-1. Gradle JVM 버전 업그레이드(Spring Boot 3.x/Java 17)

• Settings → Build, Execution, Deployment → Build Tools → Gradle에서 Gradle JVM을 17 버전으로 변경한다.
• 만약 JDK 17 설치가 우선되어야 하는 환경이라면, 사진에서처럼 Add SDK → Download JDK...로 들어가 다운로드가 가능하다.

---

3-2. Spring Boot 다운그레이드(Spring Boot 2.x/Java 11)

Java 11 사용 강의를 듣던 중 발생한 오류였기에, 스프링부트(Spring Boot) 다운그레이드하는 방향을 선택했다.

• 스프링 이니셜라이저(Spring Initializr) 참고해 build.gradle 파일에 명시된 스프링부트(Spring Boot) 버전을 수정한다.
  • 'SNAPSHOT'은 아직 개발 중인 버전을, 'M(Milestone)'은 정식 릴리즈 전 사용자 테스트 버전을 의미한다. 이밖에 별도 표기 없는 버전들은 정식 릴리즈 된 버전으로 안정성 높은 스프링 라이브러리를 제공한다.

---

📁References

https://stackoverflow.com/questions/74931848/spring-boot-3-x-upgrade-could-not-resolve-org-springframework-bootspring-boot