Spring Boot API调用时随机出现No suitable HttpMessageConverter问题排查求助

一、核心问题拆解 #

你的问题本质是单例RestTemplate实例在运行时被第三方代码动态追加HttpMessageConverter，导致转换器集合状态异常，偶尔出现JSON响应匹配失败；重启后恢复是因为实例重新初始化，直到再次被修改为止。

二、关键疑问解答 #

1. 为何RestTemplate初始化后被追加转换器？ #

RestTemplate的getMessageConverters()返回的是可修改的ArrayList，而非不可变集合，以下几种场景会导致转换器被追加：

• 第三方库/自定义代码的主动修改：某些依赖（如链路追踪工具、监控组件）或自定义逻辑会通过restTemplate.getMessageConverters().add(...)添加转换器，尤其是懒加载的Bean，可能在首次请求触发初始化时修改实例。
• RestTemplateCustomizer的作用：即使排除了RestTemplateAutoConfiguration，其他配置类或starter可能注册了RestTemplateCustomizer，会对所有RestTemplate实例执行自定义逻辑（包括添加转换器）。
• 多线程并发修改：如果有代码在请求线程中动态修改转换器，且未做线程安全控制，会导致集合被异步追加元素。

2. 并发/负载是否影响行为？如何本地复现？ #

并发本身不会直接影响转换器的匹配逻辑，但高负载会触发懒加载Bean的初始化，而这些Bean可能包含修改RestTemplate的逻辑，从而暴露问题。本地复现方法：

• 模拟懒加载场景：创建一个依赖RestTemplate的懒加载Bean（标记@Lazy），在其初始化方法中添加转换器，然后用线程池模拟多线程并发触发该Bean的初始化与API调用。
• 模拟并发修改：写一个测试类，用多个线程同时调用restTemplate.getMessageConverters().add(new SomeConverter())，同时发起API请求，观察是否出现匹配异常。

3. 能否动态重新初始化RestTemplate或转换器？ #

可以，有两种可行方案：

• 动态重置转换器集合：封装重置方法，在检测到异常时将转换器恢复为初始状态：

  public void resetRestTemplateConverters(RestTemplate restTemplate) {
      // 重新构建初始化时的7个转换器（包含MappingJackson2HttpMessageConverter）
      List<HttpMessageConverter<?>> originalConverters = new ArrayList<>();
      originalConverters.add(new MappingJackson2HttpMessageConverter());
      // 依次添加其他初始转换器...
      restTemplate.setMessageConverters(originalConverters);
  }
  

  可在捕获No suitable HttpMessageConverter异常时调用该方法，或定时检查转换器数量，超出预期则自动重置。
• 替换为线程安全的客户端：改用Spring WebClient（非阻塞、线程安全），从根源避免实例被动态修改的问题。

三、具体排查步骤 #

1. 定位转换器修改来源 #

• 用切面追踪修改行为：编写AspectJ切面拦截List.add()方法，记录调用栈：

  @Aspect
  @Component
  public class ConverterModificationTracker {
      @Pointcut("execution(* java.util.List.add(..)) && target(converters)")
      public void trackConverterAdd(List<HttpMessageConverter<?>> converters) {}
  
      @Before("trackConverterAdd(converters)")
      public void beforeAdd(JoinPoint jp, List<HttpMessageConverter<?>> converters) {
          // 仅追踪RestTemplate的转换器集合
          if (converters.getClass().getEnclosingClass() == RestTemplate.class) {
              new RuntimeException("Converter added by:").printStackTrace();
          }
      }
  }
  

• 用Arthas监控：在线上/预发环境使用Arthas执行以下命令，监控转换器添加操作：

  watch org.springframework.web.client.RestTemplate getMessageConverters 'return target.getMessageConverters().add(params[0])' -x 2
  

2. 检查RestTemplateCustomizer实例 #

通过Spring上下文获取所有RestTemplateCustomizer Bean，查看是否有自定义或第三方实现：

@Autowired
private List<RestTemplateCustomizer> customizers;

// 在启动日志中打印所有Customizer
customizers.forEach(c -> log.info("RestTemplateCustomizer found: {}", c.getClass().getName()));

3. 排查第三方依赖 #

执行mvn dependency:tree（或Gradle对应命令），检查是否包含以下类型的依赖：

• 链路追踪工具（如SkyWalking、Zipkin）
• HTTP客户端扩展库
• 监控或APM组件
  这些组件可能会自动修改RestTemplate配置。

四、临时解决方案 #

在RestTemplate初始化后，将转换器集合设置为不可变，阻止后续修改：

@Bean
@Primary
public RestTemplate restTemplate() {
    setTrustStore();
    final RestTemplate restTemplate = new RestTemplate(requestFactory());
    restTemplate.getInterceptors().add(CustomInterceptors.Builderof().build());
    // 转换为不可变集合，禁止后续修改
    restTemplate.setMessageConverters(Collections.unmodifiableList(restTemplate.getMessageConverters()));
    return restTemplate;
}

这样任何尝试添加转换器的代码都会抛出UnsupportedOperationException，快速定位问题来源。

内容的提问来源于stack exchange，提问作者Adarsh Pandey