Spring Boot/Java 버전 업

[whqtker]

관련 이슈

#658

---

현재 버전

• Spring Boot: 3.1.5
• Java : 17

---

• 현재 Spring Boot 3.1.5는 지원 중단이라 업그레이드하는 목적이 강함.

버전 선택

Spring Boot: 3.5.x

• 근거: 버전 업의 가장 큰 근거는 레거시 탈피임. 굳이 메이저 버전을 올릴 필요가 없음. 같은 메이저 내 최신 마이너 버전인 3.5.x를 선택하자.
• 마이너 버전 이동이므로 변경에 대한 예측이 유리할 것으로 예상.
• 추후 Spring AI 사용을 고려 중인데, 3.5.x는 Sprinng AI 1.x의 지원 범위에 포함됨. good
• 4.x.x은 Spring Framework 7 위에 구축되는데, 이것이 목표가 아니라면 굳이 ? 또한 평소보다 더 관여가 필요하다고 공식적으로 언급됨.
• Spring AI 또한 Boot 4를 선택하는 경우 2.x를 선택해야 하는데, 안정성 측면에서 불확실성이 있음.

Java: 17 -> 21

• 근거: Boot 3.5에서 최소 자바 지원 버전은 17임. (맥시멈은 25)
• 같이 버전을 21로 업그레이드하는 경우 변수가 생기고, 원인 추적에 어려울 거 같음.
• 일단 버전은 17로 유지하되, 추후 21 또는 25로 업그레이드하자.
• 그럼 21, 25 중 어떤 버전을 선택할까 ?
• 일단 21로 가고, 추후 필요 시 25로

계획

⭐️⭐️⭐️

• Spring Boot 버전 업그레이드 (3.1.5 -> 3.5.11)
• 작업일 기준 가장 최신 버전은 3.5.11이었기에, 해당 버전 선택
• Java 버전 업그레이드(build.gradle, CI/CD 스크립트) (17 -> 21)
• Spring AI 등 추가 기술을 사용하기 위해
• Dockerfile JDK 버전 업그레이드 (17 -> 21)
• deprecated된 @MockBean, @SpyBean을 @MockitoBeanm @MokitoSpyBean으로 변경
• Spring Boot 3.4.0을 기점으로 deprecated되었습니다.
• javax.xml.bind:jaxb-api 제거
• 해당 의존성은 JJWT 0.9.1의 런타임 의존성으로 추가되어 있었습니다. JJWT 0.9.x는 Java 9+에서 javax.xml.bind 패키지가 기본으로 포함되지 않았기 때문입니다. JJWT 버전을 업그레이드하면서 불필요해졌기에 제거합니다.
• spring.mvc.path match.matching-strategy: ANT_PATH_MATCHER 삭제
• Spring Boot 3.4.x부터 deprecated되었고, Spring Boot 4.x에서 제거될 예정입니다.
• Spring Security 6.x (Spring Boot 3.x) 에서 requestMachers() 는 PathPatternRequestMatcher 를 기본적으로 사용합니다. MVC 설정과 매핑 불일치로 인해 보안 취약점이 발생할 수 있습니다. [실제 사례] 공식 문서에서도 PathPatternRequestMatcher 방식을 권장하고 있습니다.
• database: mysql 제거
• Hibernate가 JDBC URL로 자동 감지가 가능합니다. 해당 기능은 Hibernate 6.x에 안정화되었고, Spring Boot 3.x는 Hibernate 6.x을 사용합니다.

• driverClassName: com.mysql.cj.jdbc.Driver 제거
• 하나의 JDBC 드라이버를 사용하는 경우 굳이 명시하지 않아도 무방합니다. 자동으로 감지합니다. [참고]
• cloud.aws.stack.auto: false 제거
• Spring Cloud AWS 2.x 레거시 프로퍼티이며, 3.x에서는 무의미합니다. [참고]
• import static io.jsonwebtoken.lang.Strings.hasText -> import static org.springframework.util.StringUtils.hasText (LanguageTestScoreFilterRepositoryImpl)
• JJWT 버전 업에 따른 변경
• io.awspring.cloud:spring-cloud-aws-starter-parameter-store 버전 업
• 공식 문서를 참조하여 3.4.x 버전으로 수정합니다.

⭐️

• gradle plugin의 io.spring.dependency-management, org.flywaydb.flyway 버전을 최신 버전으로
• JJWT 버전 업그레이드 (0.9.1 -> 0.12.6)
• 0.9.1 버전은 레거시
• commons-lang3 추가
• JJWT 0.12.x부터 Enum 기반 설계가 제거되었음을 확인할 수 있고, EnumUtils가 제거되었습니다. 이에 Enum 관련 메서드를 사용하기 위해 해당 라이브러리를 추가합니다.
• 그러나 실제로 사용되는 메서드는 EnumUtils.isValidEnum() 뿐이고, 실제로 사용되는 부분도 많지 않습니다. 이를 위해 라이브러리를 추가하기보다, PostCategory Enum에 검증 로직을 두는 것이 더 좋을 거 같습니다. 검증 책임 또한 라이브러리가 아니라 해당 Enum 클래스가 지게 됩니다.

• spring.tomcat.threads.min-spare -> server.tomcat.threads.min-spare (잘못된 prefix)
• Redis Serializer Deprecated 생성자 교체
• Jackson2JsonRedisSerializer<>(Object.class) -> Jackson2JsonRedisSerializer<>(new ObjectMapper(), Object.class)
• 현재 생성자는 레거시입니다. [참고]

---

• 이후 'org.springframework.boot:spring-boot-properties-migrator' 로 검증한다.
• 최종적으로 빌드 및 테스트가 정상적으로 수행되는지 확인한다.

[sukangpunch]

@whqtker
저도 동의합니다! commons-lang3 추가에 대하여 오직 이전에 활용하던 EnumUtils를 위해 라이브러리를 가져오는 것이 비효율적이라 생각합니다
또한, 직접 검증 로직을 작성하는 게 더 저희 서비스에 맞게 커스텀 할 수 있어서 확실하게 직구(직접 구현) 이 맞는 듯 합니다.