Spring Version 7.0 Relase Notes Summary

2025년 11월에 예정된 Spring Framework 7.0 릴리즈 노트에 관한 간단한 정리 및 번역 글.

• https://github.com/spring-projects/spring-framework/wiki/Spring-Framework-7.0-Release-Notes

 

Upgrading From Spring Framework 6.2

1. 주요 의존성 및 요구사항 변경

최소 요구사항 상향

• JDK 17을 기본으로 유지하면서 JDK 25 LTS 권장
• Jakarta EE 11 기준선 도입
• Kotlin 2.2 및 GraalVM 24 지원

구체적인 라이브러리 버전 업데이트:

• Servlet 6.1 (Tomcat 11.0, Jetty 12.1)
• JPA 3.2 (Hibernate ORM 7.1)
• Bean Validation 3.1 (Hibernate Validator 9.0)
• Netty 4.2, Kotlin 2.2, JSONassert 2.0

 

2. 제거 기능

모듈 제거:

• spring-jcl 모듈이 Apache Commons Logging 1.3.0으로 대체

어노테이션 지원 중단:

• javax.annotation 및 javax.inject 패키지의 어노테이션 지원 중단
• @javax.annotation.Resource, @javax.annotation.PostConstruct, @javax.inject.Inject 등을 jakarta.annotation 및 jakarta.inject 패키지로 마이그레이션 필요

Path Mapping 옵션 제거:

• suffixPatternMatch/registeredSuffixPatternMatch, trailingSlashMatch, favorPathExtension/ignoreUnknownPathExtensions 등 완전 제거

기타 API 제거:

• ListenableFuture → CompletableFuture로 대체
• WebJars 지원에서 webjars-locator-core → webjars-locator-lite로 변경
• OkHttp3 지원 제거

 

3. 지원 중단(Deprecated) 기능들

• Spring MVC의 <mvc:*> XML 설정 네임스페이스가 Java 설정 방식으로 권장
• Kotlin 스크립트 템플릿 지원 중단
• Spring TestContext Framework의 JUnit 4 지원 중단, JUnit Jupiter의 SpringExtension 권장
• Jackson 2.x 지원 중단, Jackson 3.x로 전환
• Spring MVC에서 PathMatcher 사용 중단
• HandlerMappingIntrospector SPI 중단

 

 

4. 주요 API 변경사항

Null Safety:

• JSR 305 기반의 Spring nullness 어노테이션이 JSpecify 어노테이션으로 변경

HttpHeaders API:

• HttpHeaders 클래스가 더 이상 MultiValueMap 계약을 확장하지 않음
• 여러 메서드가 제거되고 HttpHeaders#asMultiValueMap 같은 대체 메서드가 @Deprecated로 표시

GraalVM 메타데이터 형식 변경:

• 리소스 힌트 구문이 java.util.regex.Pattern에서 "glob pattern" 형식으로 변경
• 타입에 대한 reflection 힌트 등록이 메서드, 생성자, 필드 검사를 암시하도록 변경

 

 

New and Noteworthy

1. 새로운 프로그래밍 모델

BeanRegistrar 계약:

• @Configuration 클래스의 단일 @Bean 메서드 내에서 여러 빈을 등록을 해서는 안됨. (@Bean 메서드 하나당 하나의 빈만 등록)
• @Bean 메서드는 반환 타입을 선언할 때 가능한 구체적인 타입을 명시를 권장 (반환 타입은 List나 Map 같은 추상 타입이 아니라 실제 구체 클래스 타입을 쓰는 게 원칙)

 

2. SpEL 표현식 개선

Optional 타입 지원 강화:

• java.util.Optional 타입에 대한 null-safe 연산 지원 (null-safe 연산자(?.) 를 사용)
• Elvis 연산자를 사용한 Optional 자동 언래핑 지원

 

user?.name

• 동작 방식
  1. user가 null 또는 Optional.empty() → 결과는 null
  2. 값이 있으면 user.get().getName() 호출과 동일

 

name?.orElse('Unknown')

• Optional 자체의 메서드(orElse, map, filter 등)는 그대로 호출 가능
  1. name이 비어 있으면 "Unknown" 반환
  2. 값이 있으면 name.get() 반환

 

names?.?[#this.length > 5]

• 컬렉션 Optional 예시
  • names가 null 또는 Optional.empty() → 결과는 null
  • 값이 있으면 내부 List<String>을 대상으로 길이가 5 초과인 문자열 필터링 수행
    (names.get().stream().filter(...).toList()와 동일)

 

3. 프록시 설정 개선

글로벌 프록시 타입 기본값:

• Spring Boot와 같은 CGLIB 글로벌 프록시 타입 기본값이 모든 프록시 프로세서(@Async 등 포함)에 일관되게 적용
• 커스텀 목적을 위해 AutoProxyUtils.DEFAULT_PROXY_CONFIG_BEAN_NAME 이름으로 ProxyConfig 타입의 빈 선언 가능

@Proxyable 어노테이션:

• 개별 빈에 대한 프록시 설정 제어를 위한 새로운 @Proxyable 어노테이션
• @Proxyable(INTERFACES) 또는 @Proxyable(TARGET_CLASS)로 프록시 타입 지정 가능
• @Proxyable(interfaces=MyService.class)를 통한 빈별 프록시 인터페이스 지정 가능

 

4. Spring Retry 통합

Core 모듈 통합:

• Spring Retry 프로젝트가 spring-core 모듈의 org.springframework.core.retry 패키지로 통합
• 불필요한 기능 제거 및 API 재검토를 통한 기초적인 재시도 지원 제공

Resilience 어노테이션:

• spring-context 모듈에 @Retryable 어노테이션 지원
• Spring의 동시성 스로틀 지원 기반 @ConcurrencyLimit 어노테이션
• @EnableResilientMethods를 통한 편리한 활성화
• @Retryable이 리액티브 메서드에 자동 적응하여 Reactor의 재시도 기능으로 파이프라인 장식

 

5. 테스트 컨텍스트 관리 개선

자동 컨텍스트 관리:

• 테스트 실행 시 생성된 ApplicationContext는 테스트 컨텍스트 캐시에 저장됨.
• Spring 7.0부터는 캐시에 저장된 컨텍스트가 더 이상 사용되지 않으면 자동으로 pause 상태로 전환됨.
• 다시 필요할 때 캐시에서 가져오면 자동으로 restart 되어 원래의 라이프사이클 상태가 복원됨

 

 

컨텍스트 캐시 모니터링: 

logging.level.org.springframework.test.context.cache=DEBUG

• 테스트가 많을 경우 여러 ApplicationContext가 캐시에 쌓여 실행 속도가 느려질 수 있음.
• 캐시 현황(컨텍스트 몇 개 로드되었는지, 얼마나 캐시되어 있는지)을 보려면:로깅 레벨을 설정하면 캐시 상태를 로그에서 확인 가능.

 

자동 일시 정지 효과: 

• ApplicationContext 내부의 자동 시작(auto-startup) Bean 들도 함께 정지됨.
• (예: JMS 리스너 컨테이너 + 스케줄러 태스크 + Lifecycle / SmartLifecycle 인터페이스 구현체
• 테스트 중에 사용되지 않는 동안에는 백그라운드 프로세스가 불필요하게 실행되지 않음.
• 단, SmartLifecycle#isPauseable() = false를 반환하면 해당 컴포넌트는 일시 정지에서 제외 가능.

 

6. 새로운 클라이언트 지원

JmsClient 도입:

• JdbcClient와 RestClient에 이어 새로운 JmsClient 도입
• JMS 대상에 대한 일반적인 send/receive 연산 제공
• Spring의 공통 Message 또는 페이로드 값 처리, spring-messaging 모듈과 일치하는 MessagingException 발생
• JmsMessagingTemplate의 대안으로 Spring JmsTemplate에 위임하여 실제 연산 수행

JdbcClient 개선:

• fetch size, max rows, query timeout 등 명령문 수준 설정을 편리하게 제공

 

7. API 버전 관리 지원

Spring MVC & WebFlux가 API 버전 관리에 대한 일급(first-class) 지원을 제공:

• 서버: 요청 버전에 따라 컨트롤러/라우팅 제어 가능
• 클라이언트: 요청에 API 버전 지정 가능
• 테스트: MockMvc, WebTestClient 에서 버전 기반 요청 테스트 가능

 

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.ApiVersion;

@RestController
class UserController {

    // v1 API
    @GetMapping("/users")
    @ApiVersion("1")
    public String getUsersV1() {
        return "User list v1";
    }

    // v2 API
    @GetMapping("/users")
    @ApiVersion("2")
    public String getUsersV2() {
        return "User list v2 with more details";
    }
}

 

import org.springframework.web.reactive.function.client.WebClient;

public class ApiClient {

    private final WebClient webClient = WebClient.builder()
            .baseUrl("http://localhost:8080")
            .defaultHeader("API-Version", "2") // API 버전 지정
            .build();

    public String getUsers() {
        return webClient.get()
                .uri("/users")
                .retrieve()
                .bodyToMono(String.class)
                .block();
    }
}

 

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void testV1Users() throws Exception {
        mockMvc.perform(get("/users").header("API-Version", "1"))
                .andExpect(status().isOk())
                .andExpect(content().string("User list v1"));
    }

    @Test
    void testV2Users() throws Exception {
        mockMvc.perform(get("/users").header("API-Version", "2"))
                .andExpect(status().isOk())
                .andExpect(content().string("User list v2 with more details"));
    }
}

 

 

8. 스트리밍 및 입출력 개선

• StreamingHttpOutputMessage.Body 메서드 매개변수를 통한 요청 본문에 대한 OutputStream 제공 가능
• InputStream 또는 ResponseEntity<InputStream> 반환 값을 통한 응답 소비 가능

import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.io.*;

@RestController
@RequestMapping("/files")
public class FileController {

    // 파일 업로드 (스트리밍 방식으로 OutputStream 처리)
    @PostMapping(value = "/upload", consumes = MediaType.APPLICATION_OCTET_STREAM_VALUE)
    public ResponseEntity<String> uploadFile(InputStream inputStream) throws IOException {
        File targetFile = new File("uploaded.dat");

        try (OutputStream outputStream = new FileOutputStream(targetFile)) {
            inputStream.transferTo(outputStream); // InputStream → File
        }

        return ResponseEntity.ok("File uploaded successfully!");
    }

    // 파일 다운로드 (ResponseEntity<InputStream> 활용)
    @GetMapping(value = "/download", produces = MediaType.APPLICATION_OCTET_STREAM_VALUE)
    public ResponseEntity<InputStream> downloadFile() throws FileNotFoundException {
        File file = new File("uploaded.dat");
        InputStream inputStream = new FileInputStream(file);

        return ResponseEntity.ok()
                .contentType(MediaType.APPLICATION_OCTET_STREAM)
                .body(inputStream);
    }
}

 

 

9. Path Matching 개선

PathPattern 완전 전환:

 

• HTTP 요청 매핑을 위한 레거시 AntPathMatcher 변형 지원 중단 (spring reference - URI patterns)
• 경로 시작 부분에서 많은 경로 세그먼트 매칭 기능 추가 (예: "/**/pages/index.html")

 

📌 PathPattern vs AntPathMatcher

GPT 에게 물어본 PathPattern vs AntPathMatcher

 

10 .HTTP 메시지 컨버터 개선

1. 기존 방식

• Spring MVC에서 HTTP 요청/응답 변환은 HttpMessageConverter 들이 담당.
• 하지만 설정이 흩어져 있거나, 개별 Bean 등록 방식이 필요해서 전역적으로 일관되게 관리하기 어려움.
• WebFlux(Reactor 기반)에는 CodecConfigurer 같은 중앙화된 설정 API가 있었지만, Spring MVC/RestTemplate 쪽은 상대적으로 불편했음.

2. 새로운 HttpMessageConverters 클래스 도입

• Spring 7.0에서 HttpMessageConverters 라는 중앙 집중식 관리 클래스 도입.
• 특징:
  • 클래스패스 자동 감지 (예: Jackson, Gson, JAXB 같은 라이브러리)
  • 전역(Global) 구성 가능
  • 일관된 API 제공 → MVC, RestTemplate, RestClient 모두 지원

3. 장점

• 중앙화된 메시지 변환기 설정 API 제공
• Jackson, Gson 같은 라이브러리 자동 감지
• 서버(MVC)와 클라이언트(RestClient, RestTemplate)에서 일관된 구성 경험 제공

 

@Configuration
public class WebConfiguration implements WebMvcConfigurer {

    @Override
    public void configureMessageConverters(HttpMessageConverters.ServerBuilder builder) {
        JsonMapper jsonMapper = JsonMapper.builder()
                .findAndAddModules()
                .enable(SerializationFeature.INDENT_OUTPUT) // pretty print
                .defaultDateFormat(new SimpleDateFormat("yyyy-MM-dd")) // 날짜 포맷 지정
                .build();

        builder.jsonMessageConverter(new JacksonJsonHttpMessageConverter(jsonMapper));
    }
}

👉 ServerBuilder 를 통해 원하는 커스텀 JSON Converter를 추가/대체 가능.

 

 

11. 테스트 지원 개선

RestTestClient:

• WebTestClient의 비리액티브 변형인 새로운 RestTestClient 제공
• 라이브 서버, MVC @Controller 또는 애플리케이션 컨텍스트에 바인딩 가능
• WebTestClient와 같은 fluent API 및 어설션 기능 제공