Quartz任务调用WebClient.create触发ExchangeStrategies初始化异常问题

1. 核心触发原因 #

ExchangeStrategies.withDefaults()静态方法初始化时会预加载默认的请求/响应编解码器，其中最核心的JSON编解码器依赖Jackson相关类，如果类路径下缺少对应依赖、或依赖版本不兼容，就会触发静态代码块初始化失败，抛出ExceptionInInitializerError，最终导致DefaultExchangeStrategiesBuilder实例化失败为null。

2. 不同场景的解决方法 #

• Spring Boot项目场景
  优先引入官方WebFlux Starter，自动管理兼容依赖，无需单独配置零散依赖：

  <!-- Maven依赖配置 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-webflux</artifactId>
  </dependency>
  

  如果你不需要启动完整WebFlux服务，仅需要WebClient能力，可单独引入核心依赖：

  <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webflux</artifactId>
  </dependency>
  <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
  </dependency>
  

• 依赖已引入仍报错场景
  优先排查Jackson版本冲突，执行以下命令筛选依赖树中的Jackson相关包：

  # Maven依赖树排查命令
  mvn dependency:tree -Dincludes=com.fasterxml.jackson.core:*
  

  统一所有Jackson相关依赖版本到当前Spring版本要求的最低兼容版本即可，Spring Boot项目默认会自动管理版本，无需手动指定。

• Quartz类加载隔离特殊场景
  如果你为Quartz任务配置了独立类加载器，需要确认Spring WebFlux、Jackson相关依赖已经加入到Quartz任务的类加载路径中，避免类加载失败。

3. 临时规避方案（无JSON编解码需求时可用） #

如果你确定你的WebClient只会处理字符串、二进制等非JSON格式数据，可以手动构造不含Jackson编解码器的ExchangeStrategies，跳过默认初始化逻辑：

ExchangeStrategies customStrategies = ExchangeStrategies.builder()
        .codecs(configurer -> {
            // 移除Jackson编解码器依赖
            configurer.defaultCodecs().jackson2JsonDecoder(null);
            configurer.defaultCodecs().jackson2JsonEncoder(null);
        })
        .build();
this.webClient = WebClient.builder()
        .exchangeStrategies(customStrategies)
        .baseUrl(this.queryUrl)
        .build();

内容的提问来源于stack exchange，提问作者Jin Ma