Spring Boot 4.0 주요 변경사항과 새로운 기능

Spring Boot 4.0이 2025년 11월에 출시되었다
Spring Framework 7.0을 기반으로 한다
Jakarta EE 11 완전 호환, 향상된 Kotlin 지원, 일급 API 버저닝을 포함한다

최소 요구사항

Spring Boot 4.0은 기준 요구사항을 상향한다:

| 구성요소 | 최소 버전 | 권장 버전 | |----------|-----------|-----------| | Java | 17 (LTS) | 25 | | Kotlin | 2.2 | 2.2.20+ | | Gradle | 8.14+ | 9.x | | Maven | 3.9+ | - |

핵심 사항:

Java 17은 최소 버전으로 유지
Java 25 (2025년 9월)의 모든 기능 완전 지원
Kotlin 2.2 기준선과 K2 컴파일러 지원
GraalVM 24 네이티브 이미지 빌드 호환

주요 의존성 업그레이드

Spring 포트폴리오

| 의존성 | 버전 | |--------|------| | Spring Framework | 7.0 | | Spring Security | 7.0 | | Spring Data | 2025.1 | | Spring Session | 4.0 | | Spring Batch | 6.0 |

서드파티 라이브러리

| 라이브러리 | 버전 | |------------|------| | Hibernate | 7.1 | | Jackson | 3.0 | | Tomcat | 11.0 | | MongoDB Driver | 5.6.0 |

Jakarta EE 11 호환

Jakarta Servlet 6.1 - 최신 웹 API 지원
Jakarta Persistence 3.2 - 향상된 JPA 기능
Jakarta Validation 3.1 - 업데이트된 Bean Validation

참고: Undertow는 Servlet 6.1과 아직 호환되지 않아 지원되지 않는다. Tomcat 또는 Jetty를 사용해야 한다.

새로운 기능

HTTP Service Client

Spring Boot 4.0은 선언적 HTTP 클라이언트를 일급으로 지원한다

인터페이스를 정의하고 어노테이션을 붙이면 Spring이 런타임에 구현체를 생성한다

@HttpExchange("/api/users")
public interface UserClient {
 
    @GetExchange("/{id}")
    User getUser(@PathVariable("id") Long id);
 
    @GetExchange
    List<User> getAllUsers();
 
    @PostExchange
    User createUser(@RequestBody User user);
 
    @DeleteExchange("/{id}")
    void deleteUser(@PathVariable("id") Long id);
}

@ImportHttpServices를 사용하여 클라이언트를 구성한다:

@Configuration
@ImportHttpServices(group = "user-service", types = UserClient.class)
public class HttpClientConfig {
 
    @Bean
    public RestClientHttpServiceGroupConfigurer configurer() {
        return groups -> groups
            .filterByName("user-service")
            .forEachClient((group, builder) -> {
                builder.baseUrl("https://api.example.com");
                builder.defaultHeader("Accept", "application/json");
            });
    }
}

클라이언트 주입하여 사용:

@Service
@RequiredArgsConstructor
public class UserService {
 
    private final UserClient userClient;
 
    public User findUser(Long id) {
        return userClient.getUser(id);
    }
}

장점:

추가 의존성 불필요 (spring-web에 포함)
Virtual Thread 지원으로 효율적인 블로킹 작업
많은 경우 OpenFeign을 대체 가능

API 버저닝

Spring Boot 4.0은 내장 API 버저닝 지원을 도입한다

application.yml로 구성:

spring:
  mvc:
    apiversion:
      supported: 1.0, 2.0, 3.0
      default: 1.0
      use:
        # 전략 중 하나 선택:
        # Path segment: /api/v1/users
        path-segment: 1
        # 또는 Header: X-API-Version: 1.0
        # header: X-API-Version
        # 또는 Query param: ?version=1.0
        # query-parameter: version

컨트롤러에서 버저닝 사용:

@RestController
@RequestMapping("/api/users")
public class UserController {
 
    // v1.0에서만 사용 가능
    @GetExchange(value = "/{id}", version = "1.0")
    public UserV1Response getUserV1(@PathVariable Long id) {
        return userService.getUserV1(id);
    }
 
    // v2.0 이상에서 사용 가능
    @GetExchange(value = "/{id}", version = "2.0+")
    public UserV2Response getUserV2(@PathVariable Long id) {
        return userService.getUserV2(id);
    }
}

OpenTelemetry Starter

새로운 spring-boot-starter-opentelemetry 모듈로 관측성 설정을 간소화한다:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-opentelemetry'
}

management:
  opentelemetry:
    tracing:
      export:
        otlp:
          enabled: true
          endpoint: http://localhost:4317

JmsClient 지원

Spring Boot 4.0은 JmsTemplate의 현대적 대안으로 JmsClient를 도입한다:

@Service
@RequiredArgsConstructor
public class MessageService {
 
    private final JmsClient jmsClient;
 
    public void sendMessage(String destination, OrderEvent event) {
        jmsClient.send(destination, event);
    }
 
    public OrderEvent receiveMessage(String destination) {
        return jmsClient.receive(destination, OrderEvent.class);
    }
}

Virtual Threading 지원

Java 21+ 실행 시 가상 스레드가 완전 지원된다:

spring:
  threads:
    virtual:
      enabled: true

리액티브 프로그래밍의 복잡성 없이 효율적인 블로킹 I/O 작업 처리가 가능하다

Kotlin 지원 개선

Kotlin 2.2 기준선과 K2 컴파일러

Spring Boot 4.0은 Kotlin 2.2+를 요구하며, 다음을 포함한다:

K2 컴파일러로 더 빠른 컴파일
향상된 코드 분석
더 나은 IDE 지원

JSpecify Null-Safety

JSpecify 어노테이션은 Spring 포트폴리오 전반에 걸쳐 표준화된 null-safety를 제공한다

Kotlin 2.x는 이를 자동으로 Kotlin nullability로 변환한다:

// Spring API가 이제 적절한 Kotlin nullability를 가짐
// 더 이상 플랫폼 타입이 없음!
val user: User = userRepository.findById(id) // User 반환, User!가 아님
val maybeUser: User? = userRepository.findByEmail(email) // Nullable

코루틴 컨텍스트 전파

코루틴에서 관측성을 위한 자동 컨텍스트 전파:

spring:
  reactor:
    context-propagation: auto

@Service
class UserService(private val userRepository: UserRepository) {
 
    // 트레이싱 컨텍스트 자동 전파
    suspend fun findUser(id: Long): User {
        return userRepository.findById(id)
    }
}

Kotlin Serialization 모듈

kotlinx.serialization 지원을 위한 새로운 스타터:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-kotlin-serialization'
}

@Serializable
data class User(
    val id: Long,
    val name: String,
    val email: String
)

BeanRegistrarDsl

Kotlin DSL을 사용한 프로그래밍 방식의 빈 등록:

class MyBeanRegistrar : BeanRegistrarDsl({
    // 간단한 등록
    registerBean<UserRepository>()
 
    // 옵션과 함께 등록
    registerBean(
        name = "customService",
        prototype = true,
        lazyInit = true
    ) {
        CustomService(ref<UserRepository>())
    }
 
    // 프로파일 별 등록
    profile("production") {
        registerBean { ProductionDataSource() }
    }
 
    profile("development") {
        registerBean { DevelopmentDataSource() }
    }
})

| 이전 속성 | 새 속성 | |-----------|---------| | management.tracing.enabled | management.tracing.export.enabled | | spring.dao.exceptiontranslation.enabled | spring.persistence.exceptiontranslation.enabled |

새로운 속성

| 속성 | 기본값 | 설명 | |------|--------|------| | logging.console.enabled | true | 콘솔 로깅 활성화/비활성화 | | management.tracing.export.enabled | true | 트레이싱 익스포트 활성화 | | spring.threads.virtual.enabled | false | 가상 스레드 활성화 |

예시 구성

spring:
  threads:
    virtual:
      enabled: true
  persistence:
    exceptiontranslation:
      enabled: true
 
management:
  tracing:
    export:
      enabled: true
 
logging:
  console:
    enabled: true
  level:
    root: INFO
    com.example: DEBUG

마이그레이션 가이드

업그레이드 경로

이전 버전이라면 먼저 Spring Boot 3.5로 업그레이드
Java 버전을 17 이상으로 업데이트 (25 권장)
Kotlin 사용 시 Kotlin 버전을 2.2+로 업데이트
Gradle을 8.14+ 또는 9.x로 업데이트
OpenRewrite 마이그레이션 레시피 실행

plugins {
    id 'org.openrewrite.rewrite' version '7.x.x'
}
 
dependencies {
    rewrite 'org.openrewrite.recipe:rewrite-spring:latest.release'
}
 
// 실행: gradle rewriteRun

주요 변경사항

JUnit 4 제거: JUnit Jupiter 6만 지원
Undertow 미지원: Tomcat 또는 Jetty 사용
RestTemplate 지원 중단 경고: RestClient가 권장 대안
Hibernate 7.1 변경사항: 분리된 엔티티를 영속성 컨텍스트에 다시 연결할 수 없음
Jackson 3.0: Jackson 2.x에서 일부 API 변경

속성 마이그레이션

application.yml에서 이 속성들을 업데이트:

# 이전 (Spring Boot 3.x)
management:
  tracing:
    enabled: true
spring:
  dao:
    exceptiontranslation:
      enabled: true
 
# 이후 (Spring Boot 4.0)
management:
  tracing:
    export:
      enabled: true
spring:
  persistence:
    exceptiontranslation:
      enabled: true

지원 일정

| 버전 | OSS 지원 종료 | |------|---------------| | Spring Boot 4.0 | 2026년 11월 | | Spring Boot 3.5 | 2026년 6월 | | Spring Framework 7.0 | 2026년 11월 | | Spring Framework 6.2 | 2026년 6월 |

결론

Spring Boot 4.0은 현대적인 Java와 Kotlin 개발을 위한 상당한 개선을 가져온다