Spring Boot 2.7发行，2.5弃用，节奏太快卷不动了

缺乏、安全感 2023-10-04 18:42 9阅读 0赞

#### Spring Boot 2.7 发行说明 ####

*   *  从 Spring Boot 2.6 升级
     *   *  @SpringBootTest 属性源优先级
         *  新飞路模块
         *  H2 2.1
         *  OkHttp 4
         *  移除了 netty-tcnative 的独立依赖管理
         *  \`spring.mongodb.embedded.features\`配置属性已删除
         *  特定于 Servlet 的 Mustache 属性
         *  自动配置的 ReactiveElasticsearchTemplate 上的默认索引选项
         *  MongoDB 属性优先级
         *  在 Maven 进程中运行您的应用程序
         *  有序退出代码生成器
         *  重命名的指标标签键
         *  对 Elasticsearch 的 RestHighLevelClient 的支持已弃用
         *  Spring Boot 2.5 的弃用
     *  新的和值得注意的
     *   *  新的 Spring GraphQL 启动器
         *  支持 RabbitStreamTemplate
         *  Hazelcast\`@SpringAware\`支持
         *  Info 端点中的操作系统信息
         *  Info 端点中的 Java 供应商信息
         *  在 RSocket 处理程序方法中访问经过身份验证的主体
         *  不使用 OIDC SDK 的不透明令牌自省
         *  @DataCouchbaseTest
         *  @DataElasticsearchTest
         *  SAML2 注销的自动配置
         *  对自动配置的更改
         *   *  自动配置注册
             *  新的@AutoConfiguration 注解
         *  测试切片配置
         *  故障分析器注入
         *  Redis Sentinel 用户名支持
         *  覆盖内置清理
         *  Docker 镜像构建
         *   *  播客支持
         *  Cache2k 支持
         *  Jackson Mixin 的简化注册
         *  使用 PEM 编码证书的 Web 服务器 SSL 配置
         *  各种各样的
     *  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-firebird`（火鸟）
 *  `flyway-mysql`（MariaDB 和 MySQL）
 *  `flyway-sqlserver`（SQL 服务器）

如果您使用 Flyway 管理上述数据库之一的架构，请添加对相应新模块的依赖项。

#### H2 2.1 ####

Spring Boot 2.7 已经升级到 H2 2.1.120。H2 2.x 向后不兼容并修复了许多安全漏洞。有关更改的详细信息以及如何处理升级，请参阅[H2 更改日志][H2]和[迁移指南。][Link 1]

#### OkHttp 4 ####

由于不再维护 OkHttp 3，Spring Boot 2.7 已升级到 OkHTTP 4。作为此次升级的一部分，用于控制 OkHttp 版本的属性已从 更改`okhttp3.version`为`okhttp.version`。

OkHttp 4 旨在向后兼容 OkHttp 3。如果您的应用程序不是这种情况，或者出于其他原因希望继续使用 OkHttp 3，`okttp.version`请在构建中配置该属性。

#### 移除了 netty-tcnative 的独立依赖管理 ####

`netty-tcnative`已删除单独的依赖管理，以支持 Netty 的 bom 提供的依赖管理。这确保了 的版本`netty-tcnative`将与 Netty 默认使用的版本保持一致。由于此更改，该`netty-tcnative.version`属性不能再用于覆盖`netty-tcnative`. 该版本仍然可以通过提供您自己的依赖管理来覆盖，但建议它与 Netty 的默认版本保持一致。

#### `spring.mongodb.embedded.features`配置属性已删除 ####

Embedded Mongo 3.4 已放弃对配置 Mongo 功能的支持。反映这一点，`spring.mongodb.embedded.features`配置属性已被删除。对于指定功能以更改用于启动 Mongo 的命令行的高级配置，`MongodConfig`应提供自定义 bean。

#### 特定于 Servlet 的 Mustache 属性 ####

不推荐使用以下特定于 Servlet 的 Mustache 相关属性：

*  `spring.mustache.allow-request-override`
 *  `spring.mustache.allow-session-override`
 *  `spring.mustache.cache`
 *  `spring.mustache.content-type`
 *  `spring.mustache.expose-request-attributes`
 *  `spring.mustache.expose-session-attributes`
 *  `spring.mustache.expose-spring-macro-helpers`

引入了以下替换：

*  `spring.mustache.servlet.allow-request-override`
 *  `spring.mustache.servlet.allow-session-override`
 *  `spring.mustache.servlet.cache`
 *  `spring.mustache.servlet.content-type`
 *  `spring.mustache.servlet.expose-request-attributes`
 *  `spring.mustache.servlet.expose-session-attributes`
 *  `spring.mustache.servlet.expose-spring-macro-helpers`

#### 自动配置的 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`注释对 s 进行排序。使用生成的第一个非零退出代码。

#### 重命名的指标标签键 ####

中的公制标签键`camelCase`已重命名，以符合 Micrometer 的建议，即全部使用小写字母和`.`分隔符。以下指标和标签键受到影响：

<table> 
 <thead> 
  <tr> 
   <th>公制</th> 
   <th>旧标签键</th> 
   <th>新标签键</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>application.ready.time</code></td> 
   <td><code>main-application-class</code></td> 
   <td><code>main.application.class</code></td> 
  </tr> 
  <tr> 
   <td><code>application.started.time</code></td> 
   <td><code>main-application-class</code></td> 
   <td><code>main.application.class</code></td> 
  </tr> 
  <tr> 
   <td><code>cache.*</code></td> 
   <td><code>cacheManager</code></td> 
   <td><code>cache.manager</code></td> 
  </tr> 
  <tr> 
   <td><code>http.client.requests</code></td> 
   <td><code>clientName</code></td> 
   <td><code>client.name</code></td> 
  </tr> 
 </tbody> 
</table>

如果您需要恢复以前的名称，请定义一个实现修改标记键`MeterFilter`的方法的 bean 。`map(Id)`

#### 对 Elasticsearch 的 RestHighLevelClient 的支持已弃用 ####

Elasticsearch 已弃用其`RestHighLevelClient`. 与此一致，Spring Boot 的自动配置`RestHighLevelClient`已被弃用。在可能的情况下，应使用自动配置的低级别`RestClient`。或者，考虑手动配置[新客户端][Link 2]。

#### Spring Boot 2.5 的弃用 ####

在 Spring Boot 2.5 中不推荐使用的类、方法和属性已在此版本中删除。请确保在升级之前您没有调用过时的方法。

### 新的和值得注意的 ###

#### 新的 Spring GraphQL 启动器 ####

#### 支持 RabbitStreamTemplate ####

`RabbitStreamTemplate`如果使用该`spring.rabbitmq.stream.name`属性设置流名称，则自动配置A。提供了A `RabbitStreamTemplateConfigurer`，类似于`RabbitTemplateConfigurer`在保留自动配置的同时自定义其他实例。

#### Hazelcast`@SpringAware`支持 ####

自动配置的 Hazelcast 嵌入式服务器现在`SpringManagerContext`默认使用。这使得将 Spring 管理的 bean 注入到 Hazelcast 实例化的对象中成为可能。`HazelcastConfigCustomizer`还引入了回调接口，可用于进一步调整 Hazelcast 服务器配置。

#### Info 端点中的操作系统信息 ####

可以`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<String> hello (@Authenticated Principal p){
         
        return Mono.just ("Hello, "  + p.getName()) ;
    }

#### 不使用 OIDC SDK 的不透明令牌自省 ####

如果您在 OAuth2 资源服务器中使用不透明令牌自省，则自动配置的自省不再需要对`com.nimbusds:oauth2-oidc-sdk`. 根据 SDK 的其他用途，您可能能够从应用程序中删除依赖项。

#### @DataCouchbaseTest ####

`@DataCouchbaseTest`引入了用于测试使用 Spring Data Couchbase 的应用程序的新注释。有关详细信息，请参阅[更新的参考文档][Link 3]。

#### @DataElasticsearchTest ####

`@DataElasticsearchTest`引入了用于测试使用 Spring Data Elasticsearch 的应用程序的新注释。有关详细信息，请参阅[更新的参考文档][Link 4]。

#### SAML2 注销的自动配置 ####

如果您使用 Spring Security 的 SAML2 支持，您可以通过配置属性配置 RP 启动或 AP 启动的注销。有关详细信息，请参阅[更新的参考文档][Link 5]。

#### 对自动配置的更改 ####

##### 自动配置注册 #####

如果您创建了自己的自动配置，则应将注册从`spring.factories`名为`META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`. 每行包含自动配置的完全限定名称。有关示例，请参阅[包含的自动配置。][Link 6]

为了向后兼容，`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/<name of your test slice annotation>.imports`. 格式与“自动配置注册”部分中描述的新文件相同，见上文。

#### 故障分析器注入 ####

`FailureAnalyzer`实现现在可以通过提供一个将这些值中的一个或两个作为参数的构造函数来访问当前应用程序上下文的 和`BeanFactory`。`Environment`支持`BeanFactory`通过实现注入和通过实现注入`BeanFactoryAware`a的支持已被弃用，并将在未来的版本中删除。```Environment``EnvironmentAware``FailureAnalyzer```

#### Redis Sentinel 用户名支持 ####

已使用该`spring.redis.sentinel.username`属性添加了对指定用于向 Sentinel 进行身份验证的用户名的支持。

#### 覆盖内置清理 ####

`SanitizingFunction`bean 现在按顺序调用，一旦函数更改了`SanitizableData`. 如果没有`SanitizingFunction`bean 清理值，则执行内置的基于键的清理。函数通过它们的`@Order`注释或它们的`Ordered`实现来排序。

#### Docker 镜像构建 ####

##### 播客支持 #####

Maven 和 Gradle 插件现在支持在使用 Cloud Native Buildpacks 构建映像时使用 Podman 容器引擎作为 Docker 引擎的替代方案。

#### Cache2k 支持 ####

[添加了Cache2k][Cache2k]的依赖项管理和自动配置。可以通过定义`Cache2kBuilderCustomizer`bean 来自定义默认缓存设置。

#### Jackson Mixin 的简化注册 ####

Jackson 的自动配置现在将扫描您的应用程序包以查找带有`@JsonMixin`. 找到的任何类都会自动注册为带有 auto-configured 的 mixins `ObjectMapper`。

#### 使用 PEM 编码证书的 Web 服务器 SSL 配置 ####

`server.ssl.certificate`嵌入式 Web 服务器可以配置为使用 SSL 与 PEM 编码的证书和使用属性和的私钥文件`server.ssl.certificate-private-key`，以及可选的`server.ssl.trust-certificate`和`server.ssl.trust-certificate-private-key`。可以使用类似`management.server.ssl.*`的属性来保护管理端点。有关示例，请参阅[文档。][Link 7]这是作为使用 Java KeyStore 文件配置 SSL 的替代方法提供的。

#### 各种各样的 ####

除了上面列出的更改之外，还有许多小的调整和改进，包括：

*  `idlePartitionEventInterval`可以使用该`spring.kafka.listener.idle-partition-event-interval`属性配置Kafka 。
 *  `KafkaTemplate` `transactionIdPrefix`可以使用属性配置`spring.kafka.template.transaction-id-prefix`属性。
 *  Netty`maxKeepAliveRequests`可以使用该`server.netty.max-keep-alive-requests`属性进行配置。
 *  `@DataJdbcTest`自动扫描`AbstractJdbcConfiguration`bean。
 *  使用`UserDetailsService`SAML 2.0 登录时不再自动配置 bean。
 *  Spring Batch 的事务隔离级别可以使用该`spring.batch.jdbc.isolation-level-for-create`属性进行配置。
 *  现在可以通过定义自己的`FilterRegistrationBean<WebMvcMetricsFilter>`bean 来替换用于记录 Spring MVC 指标的过滤器。
 *  的 ID`DatabaseDriver.MARIADB`已从 更改`mysql`为`mariadb`
 *  in现在`InputStream`返回的实现.```RandomAccessDataFile``spring-boot-loader``available()```
 *  Spring Kafka`immediateStop`可以使用该`spring.kafka.listener.immediate-stop`属性进行配置。
 *  一个新属性 ，`spring.mustache.reactive.media-types`可用于配置响应式 Mustache 视图支持的媒体类型。
 *  Elasticsearch`RestClientBuilder`和`RestClient`beans 现在`elasticsearch-rest-client`在 classpath 上时会自动配置。如果`elasticsearch-rest-high-level-client`在类路径上，`RestHighLevelClient`bean 仍将像以前一样自动配置，但请注意，`RestHighLevelClient`现在不支持对。

### Spring Boot 2.7 中的弃用 ###

*  不推荐从加载自动配置`spring.factories`。有关更多详细信息，请参见上文。
 *  `DatabaseDriver.GAE`
 *  下的属性`spring.security.saml2.relyingparty.registration.{id}.identityprovider`已移至`spring.security.saml2.relyingparty.registration.{id}.assertingparty`。使用旧的属性名称会导致启动时出现 WARN 级别的日志消息。

[H2]: http://www.h2database.com/html/changelog.html
[Link 1]: http://www.h2database.com/html/migration-to-v2.html
[Link 2]: https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/migrate-hlrc.html
[Link 3]: https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.testing.spring-boot-applications.autoconfigured-spring-data-couchbase
[Link 4]: https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.testing.spring-boot-applications.autoconfigured-spring-data-elasticsearch
[Link 5]: https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#web.security.saml2.relying-party
[Link 6]: 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
[Cache2k]: https://cache2k.org/
[Link 7]: https://docs.spring.io/spring-boot/docs/2.7.0-SNAPSHOT/reference/htmlsingle/#howto.webserver.configure-ssl