# spring-boot 2.7 更新记录
# Spring Boot 2.7 发行说明
### 页数 196 页数
[**家 **](https://github.com/spring-projects/spring-boot/wiki)
[**支持的版本 **](https://github.com/spring-projects/spring-boot/wiki/Supported-Versions)
## 发行说明
[**v3.1 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.1-Release-Notes)
[**v3.0 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Release-Notes)
[**v2.7 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.7-Release-Notes)
[**旧版本 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Older-Release-Notes)
## 迁移指南
[**v2.7 → v3.0 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide)
[**v2.4+ 配置数据 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Config-Data-Migration-Guide)
[**v1.5 → v2.0 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide)
## 帮助
[**配置绑定 **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Configuration-Binding)
[**IDE 绑定功能 **](https://github.com/spring-projects/spring-boot/wiki/IDE-binding-features)
[**基于 Spring Boot 构建 **](https://github.com/spring-projects/spring-boot/wiki/Building-On-Spring-Boot)
[**使用 GraalVM 进行 Spring Boot **](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-with-GraalVM)
## 开发流程
[**使用代码 **](https://github.com/spring-projects/spring-boot/wiki/Working-with-the-Code)
[**团队实践 **](https://github.com/spring-projects/spring-boot/wiki/Team-Practices)
[**使用 Git 分支 **](https://github.com/spring-projects/spring-boot/wiki/Working-with-Git-branches)
[**合并拉取请求 **](https://github.com/spring-projects/spring-boot/wiki/Merging-Pull-Requests)
[**有用的 Git 别名 **](https://github.com/spring-projects/spring-boot/wiki/Useful-git-aliases)
[**GitHub 问题 **](https://github.com/spring-projects/spring-boot/wiki/GitHub-Issues)
[**Maven POM 文件 **](https://github.com/spring-projects/spring-boot/wiki/Maven-POM-Files)
[**性能调优 **](https://github.com/spring-projects/spring-boot/wiki/Performance-Tuning)
[**生成 SSL 密钥库 **](https://github.com/spring-projects/spring-boot/wiki/Generating-SSL-KeyStores)
[**弃用 **](https://github.com/spring-projects/spring-boot/wiki/Deprecations)
[**创建新的维护分支 **](https://github.com/spring-projects/spring-boot/wiki/Creating-A-New-Maintenance-Branch)
##### 在本地克隆此 wiki
# Spring Boot 2.7 发行说明
## 从 Spring Boot 2.6 升级
### @SpringBootTest 属性源优先级
`@SpringBootTest`使用属性 `properties`或注释添加的测试属性源 `@TestPropertySource`现在添加到命令行属性源上方。 `@SpringBootTest`如果您遇到了同时使用 `properties`and （并且具有相同属性名称）的情况 `args`，您可能需要进行更改。
### 新的飞行路线模块
Spring Boot 2.7 升级到 Flyway 8.5（从 8.0）。自8.0版本以来，Flyway对多种数据库的支持被提取到新的模块中：
如果您使用 Flyway 管理上述数据库之一的架构，请添加对相应新模块的依赖项。
### H2 2.1
Spring Boot 2.7 已升级至 H2 2.1.120。H2 2.x 向后不兼容，并修复了许多安全漏洞。有关更改的详细信息以及如何处理升级，请参阅 [H2 更改日志 ](http://www.h2database.com/html/changelog.html)和 [迁移指南。 ](http://www.h2database.com/html/migration-to-v2.html)
#### 乔奥Q
没有与 Java 8 和 H2 2.x 兼容的 jOOQ 开源版本。如果您使用的是 Java 11，请考虑使用该 `jooq.version`属性升级到 jOOQ 3.16 或更高版本。如果您使用的是 Java 8 并且无法升级，请考虑购买 jOOQ Professional Edition，从 H2 迁移到另一个数据库，或者作为最后的手段，降级到 H2 1.4.x。
### Microsoft SQL Server JDBC 驱动器 10
Spring Boot 2.7 已将 MSSQL 驱动程序从 v9 升级到 v10。更新后的驱动程序现在默认启用加密，这可能会破坏现有应用程序。 [您可以在本文 ](https://thewindowsupdate.com/2022/02/01/jdbc-driver-10-2-for-sql-server-released/)的“重大更改”部分中了解有关更改的信息。
建议的建议是在服务器上安装受信任的证书或更新 JDBC 连接 URL 以包含 `encrypt=false`.
### 好的HTTP 4
由于 OkHttp 3 不再维护，Spring Boot 2.7 已升级到 OkHTTP 4。作为此升级的一部分，用于控制 OkHttp 版本的属性已从 更改 `okhttp3.version`为 `okhttp.version`。
OkHttp 4 旨在向后兼容 OkHttp 3。如果您的应用程序不是这种情况，或者由于其他原因希望继续使用 OkHttp 3，请 `okttp.version`在 build.gradle 文件中配置该属性。
### 删除了 netty-tcnative 的单独依赖管理
单独的依赖管理 `netty-tcnative`已被删除，取而代之的是 Netty 的 bom 提供的依赖管理。这可以确保 的版本 `netty-tcnative`与 Netty 默认使用的版本一致。由于此更改，该 `netty-tcnative.version`属性不能再用于覆盖 `netty-tcnative`. 仍然可以通过提供自己的依赖管理来覆盖该版本，但建议它与 Netty 的默认版本保持一致。
### 配置属性已删除
嵌入式 Mongo 3.4 已放弃对配置 Mongo 功能的支持。反映这一点的是， `spring.mongodb.embedded.features`配置属性已被删除。对于指定功能来更改用于启动 Mongo 的命令行的高级配置， `MongodConfig`应提供自定义 bean。
### Servlet 特定的 Mustache 属性
以下特定于 Servlet 的 Mustache 相关属性已被弃用：
已引入以下替代品：
### 自动配置的 ReactiveElasticsearchTemplate 上的默认索引选项
自动配置的默认索引选项 `ReactiveElasticsearchTemplate`已更改，以使其与 Spring Data Elasticsearch 保持一致。以前，默认值为 `strictExpandOpenAndForbidClosed`. 他们现在 `strictExpandOpenAndForbidClosedIgnoreThrottled`。要恢复旧的索引选项，请定义您自己的 `reactiveElasticsearchTemplate`bean：
```
@Bean
ReactiveElasticsearchTemplate reactiveElasticsearchTemplate(ReactiveElasticsearchClient client,
ElasticsearchConverter converter) {
ReactiveElasticsearchTemplate template = new ReactiveElasticsearchTemplate(client, converter);
template.setIndicesOptions(IndicesOptions.strictExpandOpenAndForbidClosed());
return template;
}
```
### MongoDB 属性优先级
以前，如果 `spring.data.mongodb.uri`与任何等效的单独属性（例如 `spring.data.mongodb.host`和 ）一起配置 `spring.data.mongodb.port`，则会引发异常。该 `uri`属性现在优先于任何单独的属性 - `spring.data.mongodb.uri`设置时它们将被忽略。这使行为与其他类似属性（例如 `spring.redis.url`.
### 在 Maven 进程中运行您的应用程序
Maven 插件的目标 `spring-boot:run`是 `spring-boot:start`在默认处理的分叉中运行您的应用程序。可以使用 `fork`插件的属性来禁用此行为。该属性现已弃用，没有替代品。
### 有序退出代码生成器
`ExitCodeGenerator`现在根据其 `Ordered`实现和 `@Order`注释进行排序。使用生成的第一个非零退出代码。
### 指标标签键已重命名
中的公制标签键已 `camelCase`重命名，以符合 Micrometer 的建议，即使用全部小写字母和 `.`分隔符。以下指标和标签键受到影响：
如果您需要恢复以前的名称，请定义一个实现修改标签键的方法 `MeterFilter`的 bean 。 `map(Id)`
### 已弃用对 Elasticsearch 的 RestHighLevelClient 的支持
Elasticsearch 已弃用其 `RestHighLevelClient`. 与此一致，Spring Boot 的自动配置 `RestHighLevelClient`已被弃用。 `RestClient`如果可能，应使用自动配置的低级别。或者，考虑手动配置 [新客户端 ](https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/migrate-hlrc.html)。
### R2DBC 驱动程序更改
在 [Borca 版本 ](https://r2dbc.io/2022/02/04/r2dbc-borca-released)`r2dbc-postgresql`中， PostgreSQL 驱动程序的组 ID已从 更改 `io.r2dbc`为 `org.postgresql`。 `r2dbc-mysql`，MySQL 的驱动程序已被删除。考虑用作 `r2dbc-mariadb`替代品。
### 从 WebSecurityConfigurerAdapter 迁移到 SecurityFilterChain
Spring Boot 2.7 升级到 Spring Security 5.7，后者已弃用 `WebSecurityConfigurerAdapter`. 在不使用或使用 Spring Boot 的切片测试（例如 ）来 [配置 Spring Security `WebSecurityConfigurerAdapter`](https://spring.io/blog/2022/02/21/spring-security-without-the-websecurityconfigureradapter)`@WebMvcTest`时，您可能需要对应用程序进行一些更改，以便通过安全配置类使您的 `SecurityFilterChain`bean 可用于测试。有关更多详细信息， `@Import`请参阅 [参考文档。 ](https://docs.spring.io/spring-boot/docs/2.7.x/reference/html/howto.html#howto.testing.slice-tests)
### 使用 Maven Shade 插件和 Gradle Shadow 插件构建 Jars
Spring Boot 2.7 改变了自动配置和管理上下文类的发现方式。它们现在分别在名为 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`和 的 文件中声明 `META-INF/spring/org.springframework.boot.actuate.autoconfigure.web.ManagementContextConfiguration.imports`。
#### Maven Shade插件的配置
如果您使用的是 `maven-shade-plugin`并且不依赖于 `spring-boot-starter-parent`，请添加以下 `AppendingTransformer`配置：
```
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
META-INF/spring/org.springframework.boot.actuate.autoconfigure.web.ManagementContextConfiguration.imports
```
#### Gradle Shadow 插件的配置
添加以下配置以附加文件 `.imports`：
```
tasks.withType(ShadowJar).configureEach {
append("META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports")
append("META-INF/spring/org.springframework.boot.actuate.autoconfigure.web.ManagementContextConfiguration.imports")
}
```
### MIME拉
的依赖管理 `org.jvnet.mimepull:mimepull`已被删除。如果您已声明对 的依赖项 `mimepull`，请将满足您需要的版本添加到该声明中。
### 已弃用对 Hazelcast 3.0 的支持
Hazelcast 3 支持已弃用。如果仍然需要降级到 Hazelcast 3， `hazelcast-client`应该添加到类路径中来配置客户端。
### Spring MVC `requestMappingHandlerMapping`不再是主要的
从Spring Framework 5.1开始，Spring MVC已经支持多个 `RequestMappingHandlerMapping`bean。为了与此保持一致，Spring Boot 2.7 不再将 MVC 的主 `requestMappingHandlerMapping`bean 定义为 `@Primary`. 万一您正在注入 `RequestMappingHandlerMapping`，如果上下文中有多个此类 bean，您现在需要使用它 `@Qualifier`来选择您希望注入的候选者。或者，可以使用 注入所有候选者 `List`。
### MySQL JDBC 驱动程序
MySQL JDBC 驱动程序的坐标已更改。 `com.mysql:mysql-connector-j`8.0.31还发布到 `mysql:mysql-connector-java`. 在 8.0.32 及更高版本中，它仅发布到 `com.mysql:mysql-connector-j`. Spring Boot 2.7.8 升级至 8.0.32。如果您使用 MySQL JDBC 驱动程序，请在升级到 Spring Boot 2.7.8 及更高版本时相应更新其坐标。
### Spring Boot 2.5 弃用
Spring Boot 2.5 中已弃用的类、方法和属性已在此版本中删除。请确保在升级之前没有调用已弃用的方法。
### 最低要求变更
没有任何。
## 新的和值得注意的
### 新的 Spring GraphQL 启动器
Spring Boot 2.7通过新的启动器提供了对 [Spring GraphQL 项目 ](https://github.com/spring-projects/spring-graphql)`spring-boot-starter-graphql`的支持。 [您可以在Spring Boot 参考文档的 GraphQL 部分 ](https://docs.spring.io/spring-boot/docs/2.7.x-SNAPSHOT/reference/html/web.html#web.graphql)找到更多信息。
### 支持 RabbitStreamTemplate
如果使用该属性设置流名称，则A `RabbitStreamTemplate`会自动配置 `spring.rabbitmq.stream.name`。提供了A `RabbitStreamTemplateConfigurer`，类似于 `RabbitTemplateConfigurer`自定义附加实例，同时保留自动配置。
### Hazelcast `@SpringAware`支持
`SpringManagerContext`现在默认使用自动配置的 Hazelcast 嵌入式服务器。这使得将 Spring 托管 bean 注入到 Hazelcast 实例化的对象中成为可能。还引入了回调 `HazelcastConfigCustomizer`接口，可用于进一步调整 Hazelcast 服务器配置。
### 信息端点中的操作系统信息
可以 `OsInfoContributor`公开有关应用程序运行的操作系统的一些信息：
```
{
"os": {
"name": "Linux",
"version": "5.4.0-1051-gke",
"arch": "amd64"
}
}
```
默认情况下禁用此新贡献者。可以使用该属性来启用它 `management.info.os.enabled`。
### Info 端点中的 Java 供应商信息
现有的 `JavaInfoContributor`已得到改进，提供了供应商信息的专用部分，包括供应商特定的版本。它现在不是一个顶级的 `vendor`简单属性，而是一个具有 `name`和 `version`属性的专用对象：
```
{
"java": {
"vendor": {
"name": "Eclipse Adoptium",
"version": "Temurin-17.0.1+12"
},
"..."
}
```
请注意，并非所有供应商都会公开 `java.vendor.version`系统属性，因此该 `version`属性可能是 `null`.
### 在 RSocket 处理程序方法中访问经过身份验证的主体
RSocket 处理程序方法现在可以注入 `@Authenticated` `Principal`：
```
@MessageMapping ("test")
Mono hello (@Authenticated Principal p){
return Mono.just ("Hello, " + p.getName()) ;
}
```
### 不使用 OIDC SDK 的不透明令牌自省
如果您在 OAuth2 资源服务器中使用不透明令牌内省，则自动配置的内省器不再需要依赖于 `com.nimbusds:oauth2-oidc-sdk`. 根据 SDK 的其他用途，您也许可以从应用程序中删除依赖项。
### @DataCouchbaseTest
`@DataCouchbaseTest`引入了用于测试使用 Spring Data Couchbase 的应用程序的新注释。有关详细信息，请参阅 [更新的参考文档 ](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.testing.spring-boot-applications.autoconfigured-spring-data-couchbase)。
### @DataElasticsearchTest
`@DataElasticsearchTest`引入了用于测试使用 Spring Data Elasticsearch 的应用程序的新注释。有关详细信息，请参阅 [更新的参考文档 ](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.testing.spring-boot-applications.autoconfigured-spring-data-elasticsearch)。
### SAML2 注销的自动配置
如果您使用 Spring Security 的 SAML2 支持，则可以通过配置属性配置 RP 发起或 AP 发起的注销。有关详细信息，请参阅 [更新的参考文档 ](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#web.security.saml2.relying-party)。
### 自动配置的更改
#### 自动配置注册
如果您创建了自己的自动配置，则应将注册从密钥 `spring.factories`下移至 `org.springframework.boot.autoconfigure.EnableAutoConfiguration`名为 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`. 每行包含自动配置类的完全限定名称，而不是单个逗号分隔的列表。有关示例，请参阅 [包含的自动配置。 ](https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-autoconfigure/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports)
为了向后兼容， `spring.factories`仍将保留 中的条目。
#### 新的@AutoConfiguration注释
`@AutoConfiguration`引入了新的注释。它应用于注释新 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`文件中列出的顶级自动配置类，替换 `@Configuration`. 嵌套在类中或由类导入的配置类应继续像以前一样 `@AutoConfiguration`使用。 `@Configuration`
为了您的方便，还支持通过、和属性进行 `@AutoConfiguration`自动配置排序。这可以用作 和 的替代品。 `after``afterNames``before``beforeNames``@AutoConfigureAfter``@AutoConfigureBefore`
### 测试切片配置
如果您创建了自己的测试切片，则应将注册从 移动 `spring.factories`到 下的新位置 `META-INF/spring/.imports`。该格式与“自动配置注册”部分中描述的新文件相同，请参见上文。
[有关示例， ](https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-test-autoconfigure/src/main/resources/META-INF/spring/)请参阅随附的测试切片。
### 故障分析器注入
`FailureAnalyzer`现在，实现可以通过提供一个将这些值中的一个或两个值作为参数的构造函数来访问当前应用程序上下文的 `BeanFactory`和 `Environment`。 `BeanFactory`对通过实现注入 `BeanFactoryAware`和 `Environment`通过 `EnvironmentAware`在 a 中实现注入的支持 `FailureAnalyzer`已弃用，并将在未来版本中删除。
### Redis Sentinel 用户名支持
已使用该属性添加了对指定用于向 Sentinel 进行身份验证的用户名的支持 `spring.redis.sentinel.username`。
### 覆盖内置清理
`SanitizingFunction`beans 现在按顺序调用，一旦函数更改了 .bean 的值，就会停止 `SanitizableData`。如果没有 `SanitizingFunction`Bean 清理该值，则会执行内置的基于键的清理。函数通过其 `@Order`注释或 `Ordered`实现进行排序。
### Docker 镜像构建
#### Podman 支持
在使用 Cloud Native Buildpacks 构建映像时，Maven 和 Gradle 插件现在支持使用 Podman 容器引擎作为 Docker 引擎的替代方案。
有关更多详细信息，请参阅更新的 [Gradle ](https://docs.spring.io/spring-boot/docs/2.7.0-SNAPSHOT/gradle-plugin/reference/htmlsingle/#build-image.examples.docker.podman)和 [Maven参考文档。 ](https://docs.spring.io/spring-boot/docs/2.7.0-SNAPSHOT/maven-plugin/reference/htmlsingle/#build-image.examples.docker.podman)
### Cache2k 支持
添加了 [Cache2k ](https://cache2k.org/)的依赖管理和自动配置。可以通过定义 `Cache2kBuilderCustomizer`bean 来自定义默认缓存设置。
### Jackson Mixins 的简化注册
Jackson 的自动配置现在将扫描应用程序的包中以 `@JsonMixin`. 找到的任何类都会自动注册为具有自动配置的 mixin `ObjectMapper`。
### 使用 PEM 编码证书的 Web 服务器 SSL 配置
嵌入式 Web 服务器可以配置为使用带有 PEM 编码证书和私钥文件的 SSL，使用属性 `server.ssl.certificate`和 `server.ssl.certificate-private-key`，以及可选的 `server.ssl.trust-certificate`和 `server.ssl.trust-certificate-private-key`。可以使用类似的 `management.server.ssl.*`属性来保护管理端点。请参阅 [文档 ](https://docs.spring.io/spring-boot/docs/2.7.0-SNAPSHOT/reference/htmlsingle/#howto.webserver.configure-ssl)中的示例。这是作为使用 Java KeyStore 文件配置 SSL 的替代方法提供的。
### 依赖升级
Spring Boot 2.7 迁移至多个 Spring 项目的新版本：
许多第三方依赖项也已更新，其中一些更值得注意的如下：
### 各种各样的
除了上面列出的更改之外，还进行了许多细微的调整和改进，包括：
## Spring Boot 2.7 中的弃用