Spring Framework 7.1 预览说明：计划2026年11月，HTTP QUERY 与 Multipart 强化

Spring 官方 Wiki 发布《Spring Framework 7.1 Release Notes》预览页，标注目标版本为 7.1.0、计划于2026年11月发布。文档汇总基线升级、破坏性调整、新能力与弃用项，供微服务与 Web 技术栈提前对照。页面写明「This is a preview page」，正式 GA 仍以发行说明为准。[1]

基线与兼容性变化

最低依赖上调包括：Jackson 3.1（LTS）、Hibernate ORM 7.3 支持（仍兼容 7.1/7.2）、HtmlUnit 5.4（spring-test 与 MockMvc）。HandlerMappingIntrospector 已移除，曾被 Spring Security 用于路径与 CORS 对齐的应用可能缺少 CorsConfigurationSource bean，需按文档改用 PreFlightRequestHandler 等路径。[1]

服务端 HttpMessageConverters 不再自动检测 JAXB 转换器，以降低无 XML 场景的 CPU 开销；RestTemplate/RestClient 仍会检测。WebFlux 多部分解析为 maxDiskUsagePerPart（默认 1MB）与 maxParts（默认 50）设限。ProblemDetail 的 instance 字段不再自动填请求路径。HTTP 客户端里超时值 0 统一视为「无超时」，负值与会被截断成 0 的亚毫秒 Duration 将被拒绝。[1]

观测方面，经异常处理器译成 5xx 的服务端错误会记入 HTTP server observation，指标 error 键可能从 none 变为异常类名，依赖旧告警规则的团队需复查。[1]

新能力摘要

• HTTP QUERY：跟进 RFC 10008，支持带请求体的幂等方法，可用 @RequestMapping(method = RequestMethod.QUERY)；暂未提供 @QueryMapping。[1]

• Multipart：新增可读写的 MultipartHttpMessageConverter，FormHttpMessageConverter 专注 URL 编码表单；RestClient/RestTestClient 可读 multipart 响应并测试 multipart 端点。[1]

• Problem Details：MVC 可选择将未处理异常渲染为 RFC 9457 problem+json，无需再写继承 ResponseEntityExceptionHandler 的 @ControllerAdvice。[1]

• 测试：JSON 断言支持 JsonUnit；JPA 4.0 / Hibernate 8.0 相关注入与回调有扩展支持。[1]

弃用方面，RestTemplate 及相关类型在 7.1 正式标记弃用，移除计划指向尚未排期的 Framework 8.0；AllEncompassingFormHttpMessageConverter、DataBinder.disallowedFields、Derby 支持等亦列入弃用清单。RestClient.Builder#configureMessageConverters 行为改为默认保留自动检测转换器，若要最小集合需显式 disableDefaults()。[1]

说明：以上据官方预览 Wiki 整理，正式 GA 内容以发布说明与发行版为准。

来源

[1] Spring Framework 7.1 Release Notes，spring-projects Wiki，预览页标注 2026年10月22日更新。

#Spring #Framework71 #微服务 #Java #HTTP_QUERY