SpringBoot 3.1 正式发布，赶紧上车!

Spring Boot 3.1.0 现已发布，此版本添加了大量新功能和改进。

Spring Boot 各个版本对 Java 版本的要求如下:

亮点

• Spring Authorization Server 的自动配置

• 支持在开发时使用 Testcontainers 和 Docker Compose 管理外部服务

• 简化集成测试中 Testcontainers 的配置

• 支持 Mockito 单元测试

升级 HttpClient 5

在 Spring Framework 6 中，推荐使用 Apache HttpClient 5，因此已经移除了对 Apache HttpClient 4 与 RestTemplate 的支持。Spring Boot 3.0 包含了 HttpClient 4 和 5 的依赖管理。但如果使用了 HttpClient 4 仍会导致使用 RestTemplate 时出现难以诊断的错误。

Spring Boot 3.1 为了鼓励用户改用 HttpClient 5 取代 HttpClient 4，移除了 HttpClient 4 的依赖管理。

Servet 和 Filter 注册优化

如果 ServletRegistrationBean 和 FilterRegistrationBean 类的注册失败，将抛出 IllegalStateException 异常而不是记录警告。如果需要保持旧有的行为，则需要在注册 bean 上调用 setIgnoreRegistrationFailure(true)方法。

Git Commit ID Maven 插件版本属性

覆盖 io.github.git-commit-id:git-commit-id-maven-plugin 版本的属性已更新以匹配其 artifact 名称。适应此更改，在 pom.xml 文件中需要将 git-commit-id-plugin.version 替换为 git-commit-id-maven-plugin.version。

Spring Kafka 重试主题自动配置

如果使用了 Apache Kafka 的自动配置重试主题（spring.kafka.retry.topic.enabled: true），并使用具有最大延迟的指数回退，则所有最大延迟水平的重试现在都发送到相同的主题。以前，即使超过了最大延迟，每个重试都会使用一个单独的主题。

Testcontainers 的依赖管理

Spring Boot 的依赖管理现在包括 Testcontainers。如果需要，可以使用 testcontainers.version 属性覆盖由 Spring Boot 管理的版本。

Hibernate 6.2

Spring Boot 3.1 升级到 Hibernate 6.2。请参阅 Hibernate 6.2 迁移指南，了解此更改可能对应用程序产生的影响。

Jackson 2.15

Spring Boot 3.1 升级到 Jackson 2.15。请参阅 Jackson Wiki，了解此更改可能对应用程序产生的影响。

2.15 中显着的更改是引入了处理限制。要调整这些约束，请定义一个类似于以下内容的 Jackson2ObjectMapperBuilderCustomizer：

@Bean
Jackson2ObjectMapperBuilderCustomizer customStreamReadConstraints() {
    return (builder) -> builder.postConfigurer((objectMapper) -> objectMapper.getFactory()
        .setStreamReadConstraints(StreamReadConstraints.builder().maxNestingDepth(2000).build()));
}

升级 Mockito 5

Spring Boot 3.1 升级到 Mockito 5，具体是 5.3。请参阅 Mockito 发布说明，了解 5.x 系列中的显着更改。

Health Groups 默认验证健康状态

健康组成员的配置现在将在启动时进行验证。如果包含或排除了不存在的健康指标，则启动将失败。设置 management.endpoint.health.validate-group-membership 为 false 可以禁用此验证，恢复早期版本的行为。

服务连接

引入了新的服务连接概念，由 ConnectionDetails bean 在应用程序中表示。这些 bean 提供了建立与远程服务连接所需的必要详细信息，而 Spring Boot 的自动配置已更新为消耗 ConnectionDetails bean。当这些 bean 可用时，它们将优先于任何与连接相关的配置属性。控制连接池大小和行为等与连接本身无关的配置属性仍将使用。

这项低级功能旨在作为自动配置服务连接的其他更高级特性的构建块，通过定义 ConnectionDetails bean 来实现。。

Docker Compose

新模块spring-boot-docker-compose提供了与 Docker Compose 的集成。当应用程序启动时，Docker Compose 集成将在当前工作目录中查找配置文件。支持以下文件：

• compose.yaml

• compose.yml

• docker-compose.yaml

• docker-compose.yml

要使用非标准文件，请设置 spring.docker.compose.file 属性。

默认情况下，配置文件中声明的服务将使用 docker-compose up 启动，并将这些服务的连接详细信息 bean 添加到应用程序上下文中，以便可以在不进行任何进一步配置的情况下使用这些服务。当应用程序停止时，将使用 docker-compose down 关闭服务。可以使用 spring.docker.compose.lifecycle-management、spring.docker.compose.startup.command 和 spring.docker.compose.shutdown.command 配置属性自定义此生命周期管理及用于启动和关闭服务的命令。

请参阅参考文档以获取更多详细信息，包括目前支持的服务列表。

SSL 配置

现在可以使用属性配置 SSL 信任材料，例如 Java KeyStores 和 PEM 编码的证书，并以更一致的方式应用于各种类型的连接，例如嵌入式 Web 服务器、数据服务、RestTemplate 和 WebClient。

请参阅参考文档以获取更多信息。

Spring Authorization Server 自动配置

此版本中新增了对 Spring Authorization Server 项目的支持，同时提供了新的spring-boot-starter-oauth2-authorization-server启动器。有关详细信息，请参阅 Spring Boot 参考文档中的 Authorization Server 部分。

Docker 镜像构建

镜像创建日期和时间

spring-boot:build-image Maven 目标和 bootBuildImage Gradle 任务现在具有 createdDate 配置选项，可用于将生成图像元数据中的 Created 字段的值设置为用户指定的日期或 now 以使用当前日期和时间。有关详细信息，请参阅 Gradle 和 Maven 插件文档。

镜像应用程序目录

spring-boot:build-image Maven 目标和 bootBuildImage Gradle 任务现在具有 applicationDirectory 配置选项，可用于设置在构建包消耗之前将应用程序内容上传到构建器映像中的位置。这也将是生成的映像中应用程序内容的位置。有关详细信息，请参阅 Gradle 和 Maven 插件文档。