Spring 6 中 `PropertyBatchUpdateException`：找不到匹配的编辑器，怎么解决？

2024-03-25 10:34:19

Spring 6 中解决 PropertyBatchUpdateException：找不到匹配的编辑器

作为一名经验丰富的程序员，我曾多次遇到 PropertyBatchUpdateException 错误，提示找不到匹配的编辑器或转换策略来将字符串值转换为 java.time.Duration。这个问题经常出现在 Spring 6 中，并可能导致 Http 请求失败。在这篇博客文章中，我将详细介绍这个错误及其解决方案，并提供一些技巧来避免这个问题。

错误根源

PropertyBatchUpdateException 错误通常是由于以下原因造成的：

Spring 应用程序使用的是 Jackson 1.x 版本，它不支持将字符串值转换为 java.time.Duration。
没有正确配置 HttpComponentsClientHttpRequestFactory bean 以使用 Jackson 注解。
应用程序没有提供一个有效的 connectTimeout 属性值。

解决方案

要解决这个错误，请按照以下步骤操作：

使用 Jackson 2.x 版本： 确保你的 Spring 应用程序使用 Jackson 2.x 版本，因为它提供了将字符串值转换为 java.time.Duration 所需的转换器。
添加 Jackson 依赖项： 在你的 Maven 或 Gradle 构建文件中添加 Jackson 依赖项：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.3</version>
</dependency>

启用 Jackson 注解： 在你的 Spring 配置文件中添加以下注解，以启用 Jackson 注解：

@EnableJackson2HttpMessageConverters

更新 bean 配置： 更新你的 HttpComponentsClientHttpRequestFactory bean 配置，如下所示：

<bean id="restTemplate" class="org.springframework.web.client.RestTemplate">
  <constructor-arg>
      <bean class="org.springframework.http.client.HttpComponentsClientHttpRequestFactory">
          <constructor-arg>
              <bean class="MyHttpClientFactory">
                  <property name="keepAliveMS" value="${keepalive:300000}"/>
              </bean>
          </constructor-arg>
          <property name="connectTimeout" value="${connectTimeout}"/>
          <!-- 使用 Jackson 注解来处理 `Duration` 类型 -->
          <property name="messageConverters">
              <list>
                  <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
              </list>
          </property>
    </bean>
  </constructor-arg>
</bean>