🚀 레거시 Java 8 + Spring Boot 2.1 프로젝트를 Java 17으로 업그레이드하기 (모든 것을 깨뜨리지 않으면서)

Source: Dev.to

혜택

• 2029년까지 LTS – 장기 지원 및 보안 업데이트
• 40–60 % 빠른 JVM – 향상된 GC(G1/ZGC), 빠른 실행 속도
• 현대적인 언어 기능 – var, 레코드, sealed 클래스, switch 표현식
• 메모리 사용량 개선 – 힙 풋프린트 감소
• 보안 강화 – 강력한 TLS, 암호화, JVM 규칙

업그레이드 경로

pom.xml 변경 사항

Java 버전을 11로 설정 (단계 1)

    11

누락된 Java EE 모듈 추가 (Java 11)

    javax.xml.bind
    jaxb-api
    2.3.1

Spring Boot 버전 업데이트 (단계 2)

    org.springframework.boot
    spring-boot-starter-parent
    2.7.18

Java 버전을 17로 설정 (단계 3)

    17

Spring Boot 3.x로 업그레이드 (단계 4)

    org.springframework.boot
    spring-boot-starter-parent
    3.3.4

Spring Boot 3 이전 조정 사항

• Springfox를 springdoc‑openapi로 교체
• @ConfigurationProperties에 대한 새로운 생성자 바인딩 스타일 적용
• 사용 중단된 Spring Security 설정 정리
• (선택) RestTemplate → WebClient 마이그레이션 시작

springdoc‑openapi 의존성 추가

    org.springdoc
    springdoc-openapi-starter-webmvc-ui
    2.6.0

일반적인 해결 방법

• 리플렉션 경고 – 임시로 --add-opens JVM 옵션 추가
• 레거시 HTTP 클라이언트를 최신 대안(WebClient 등)으로 교체
• 모든 서드파티 라이브러리가 Java 17을 지원하는지 확인

패키지 마이그레이션 예시 (Jakarta)

// Before (Spring Boot 2.x)
import javax.servlet.http.HttpServletRequest;

// After (Spring Boot 3.x)
import jakarta.servlet.http.HttpServletRequest;

남아 있는 javax 임포트를 찾으려면 다음 명령을 실행:

grep -R "javax" src/

Spring Security API 변경

// Old (Spring Security 5.x)
http.authorizeRequests().anyRequest().authenticated();

// New (Spring Security 6.x)
http.authorizeHttpRequests(auth -> auth
    .requestMatchers("/api/**").authenticated()
);

JPA 패키지 이름 변경

javax.persistence
jakarta.persistence

CI 설정 (GitHub Actions)

- name: Setup JDK
  uses: actions/setup-java@v3
  with:
    distribution: 'temurin'
    java-version: '17'

검토가 필요한 일반적인 컴포넌트

• 컨트롤러
• WebClient / Feign 클라이언트
• Kafka / RabbitMQ 연동
• Flyway / Liquibase 마이그레이션
• 전체 데이터베이스 워크플로

흔히 발생하는 오류와 해결 방법

업그레이드 체크리스트

• Java 8 → 11
• 제거된 Java EE 모듈 복구
• Java 11 → 17
• CI 파이프라인을 JDK 17 사용하도록 업데이트
• Spring Boot 2.1 → 2.7 업그레이드
• 사용 중단된 Spring API 제거
• Spring Boot 2.7 → 3.x 업그레이드
• javax.* 패키지를 jakarta.*로 마이그레이션
• Spring Security 설정 업데이트
• Springfox를 springdoc‑openapi로 교체
• Hibernate / JPA 의존성 업데이트
• 전체 통합 테스트 실행

이러한 단계적 접근 방식—먼저 Java 8 → 11로 업그레이드하고, 사용 중단된 API를 조기에 수정한 뒤 충분히 테스트하면—Java 17 및 Spring Boot 3.x로의 전환을 원활하고 위험을 최소화하면서 진행할 수 있습니다.