Spring Boot 4.1.2 稳定版发布：Java 27 枚举、OAuth2 与依赖升级

Spring 官方构建账号于 2026 年 10 月 22 日在 GitHub 发布 Spring Boot v4.1.2。本版是 4.1 线的稳定补丁：含一项小功能、数十项缺陷修复、文档更正，以及 Micrometer、Tomcat、Netty、Hibernate、Spring Framework 等依赖升级。同日仓库上另有 RC 线动态，本条只跟稳定标签 v4.1.2。[1]

新功能方面，JavaVersion 枚举新增 TWENTY_SEVEN，参考文档同步写明对 Java 27 的支持，便于在更高 JDK 上声明与校验运行版本（相关文档条目亦指向 #51825）。对计划在新 JDK 上试跑 Boot 4.1 的团队，这是版本探测与条件装配能识别到的枚举缺口补齐。[1]

安全与认证路径修了多处易踩坑行为。issuer-uri 为空且只配了 jwk-set-uri 时，JWT 会被错误拒绝（#52260）；OAuth2 资源服务器单独设置 authorities-claim-delimiter 时配置不生效（#51630）；另有 OAuth2ClientProperties 在已有自定义 ClientRegistrationRepository 时不可用（#51450）。数据源与 Compose 侧，凭证里含空格或冒号会导致 MongoDB、Elasticsearch、Docker Compose Mongo 连接失败；RabbitMQ Compose 在启用 SSL 时连不上；MariaDB 空密码环境变量名也曾被误识别为 MARIADB_ALLOW_EMPTY_PASSWORD 而非带 ROOT 的正确变量。[1]

Web 容器与停机：Tomcat 或 Jetty 在空闲服务器上紧接着 shutDownGracefully 再 stop，可能回调 REQUESTS_ACTIVE（#52197）；NettyWebServer 同类时序可能挂起（#52196）。会话 Cookie 在未配置 server.reactive.session.cookie.same-site 时缺少 SameSite 属性（#51639）；SSL 主机定制在 Tomcat 初始化或重载 SSL bundle 时可能丢失。gRPC 客户端在未配置子策略时 grpc 负载均衡绑定会 NPE，且客户端属性可能覆盖用户自定义；时长配置里「零周」换算会抛异常。[1]

打包与测试：嵌套 jar 缺目录项会丢 package manifest（#52258），uber jar 里 NestedJarFileResources 竞态可致 NPE（#51745）；OriginTrackedPropertiesLoader 会丢掉名称以 # 或 ! 开头的属性（#52265）；DevTools 对响应式 Web 环境识别不准；在独立端口跑 Actuator 时 Jersey 未使用 endpoint ObjectMapper。依赖升级包括 Spring Framework 7.0.10、Spring Security 7.1.2、Tomcat 11.0.27、Netty 4.2.19.Final、Micrometer 1.17.2、Hibernate 7.4.13.Final 等。[1]

已在 Boot 4.1.x 跑预发或生产、且涉及 OAuth2、优雅停机、嵌套 jar 或特殊字符凭证的团队，可评估升到 4.1.2 并做回归。完整 bug 列表与贡献者名单见发行页。[1]

来源

[1] v4.1.2，spring-projects/spring-boot，2026年10月22日。

#SpringBoot #Spring #Java27 #OAuth2 #稳定版