[쀼] Spring Boot 2.x -> Spring Boot 3.x 마이그레이션 여정

스프링 부트 3.0 마이그레이션 가이드 (번역)

• https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide

Spring Boot 3.0 Migration Guide

1) Java 버전 17 이상으로 업그레이드 하기 

- Spring Boot 3.x 은 더이상 Java8을 지원하지 않는다 

 

2) 스프링 부트를 사용 가능한 최신 버전으로 업그레이드 하기

- 2.7.x 로 업그레이드 

 

3) Spring Boot에서 관리되지 않는 종속성 확인하기 

- 스프링 부트 2.7.x : https://docs.spring.io/spring-boot/docs/2.7.x/reference/html/dependency-versions.html#appendix.dependency-versions

Dependency Versions

 

- 스프링 부트 3.0.x : https://docs.spring.io/spring-boot/docs/3.0.x/reference/html/dependency-versions.html#appendix.dependency-versions

Dependency Versions

 

시큐리티, 클라우드, 배치

(1) Spring Security

- Spring Security 6.0 사용 (Spring Boot 3.0)

   Spring Security 5.8 (Spring Boot 2.7) 로 업그레이드 한 후에 Spring Security 6.0으로 변경하기 

https://docs.spring.io/spring-security/reference/6.0/migration/index.html

Migrating to 6.0 :: Spring Security

 

- 서블릿 애플리케이션에서 Spring Secuirt 6.0은 모든 디스패치 유형에 권한 부여를 적용한다.

이에 맞춰 Spring Boot는 모든 디스패치 유형에 대해 Spring Security 필터가 호출되도록 구성한다.

디스패치 유형은 spring.security.filter.dispatcher-types 속성을 사용하여 설정할 수 있다. 

 

(2) Spring Batch 

- Spring Batch 5.0 사용 

https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide

Spring Batch 5.0 Migration Guide

더 이상 @EnableBatchProcessing 필요없음

Job과 Step을 만들 때, JobRepository, PlatformTransactionManager 파라미터가 필요함 

JobBuilderFactory와 StepBuilderFactory가 지원이 중단되었고, JobBuilder와 StepBuilder를 사용해야 함 

 

(3) Spring Cloud

- Spring Cloud Bom 업데이트

- application.yml 혹은 application.properties 수정

- Spring Cloud Sleuth를 Micrometer Tracing 으로 이관 

 

(4) Flyway : 9.22.3 

(5) Mockito : 5 사용

(6) springdoc-openapi : 부트3을 지원하기 위한 아티팩트ID 로 변경 

---

직접 해보자 

요약

- 스프링 부트 3.0 버전 : Spring Boot 3.5.4

- Java 17이상 : Java21

- 스프링 시큐리티 6.0 : Spring Security 6.0

- 스프링 부트 2.x @Deprecated 제거 

 

 

1. 자바 버전을 21로 올렸다

- 실행에 사용되는 현재 Gradle(8.13)이 Java 21과 호환되지 않아 JAR 생성 단계에서 실패했다 

 

1.1. Gradle을 8.13 버전으로 업그레이드를 했다 

- 명령어 방식 (임시로 19로 내려서 업그레이드 실행 후 다시 21로 변경)

chmod +x ./gradlew

./gradlew wrapper --gradle-version 8.13

 

- 수동 업그레이드 방식 

gradle/wrapper/gradle-wrapper.properties 파일 열어서 

distributionUrl=https:\://services.gradle.org/distributions/gradle-8.13-bin.zip 로 수정 

./gradlew clean build --refresh-dependencies

저장 후, 아래 실행

chmod +x ./gradlew

./gradlew --version 

 

2. 테스트 생략하고 실행 ./gradlew bootRun -x test

- Gradle bootRun에 Modify Run Configuration 선택 (-x test 추가)

 

- Jakarata 로 변경 : find and replace 함 ㅋ

(Ultimate버전만 된다 https://blog.jetbrains.com/idea/2021/06/intellij-idea-eap-6/# )

 

- 특정 라이브러리만 추적 하는 방법

./gradlew dependencyInsight --dependency 추적하고싶은라이브러리

1) 어떤 라이브러리가 추적하고싶은라이브러리를 끌고 오는지

2) 어떤 버전 경로로 최종 resolve되는지

3) 버전 충돌시 어떤 버전이 우선되는지

3가지를 볼 수 있다 

 

(1) gradle/wrapper/gradle-wrapper.properties 

build.gradle 의 org.springframework.boot 버전을 3.5.4 로 올렸다 

 

---

여러 마이그레이션 도와주는 도구 

1) Intellij Migration Tool

- Jakarata 로 변경

https://blog.jetbrains.com/idea/2021/06/intellij-idea-eap-6/#

IntelliJ IDEA EAP 6: Automatic Migration From Java EE to Jakarta EE, Shared Indexes for Spring Boot Projects, and More | The Int

 

2) JDK17, Maven 프로젝트에서 사용해볼 수 있음

https://github.com/spring-projects-experimental/spring-boot-migrator

GitHub - spring-projects-experimental/spring-boot-migrator: Spring Boot Migrator (SBM) is a tool for automated code migrations t

 

3) https://docs.openrewrite.org/

OpenRewrite by Moderne | Large Scale Automated Refactoring | OpenRewrite Docs

 

---

참고2. 스프링 부트3 마이그레이션

https://techblog.lycorp.co.jp/ko/how-to-migrate-to-spring-boot-3

실전! Spring Boot 3 마이그레이션