Spring Boot 2.2.0集成高版本spring-web用WebClient的依赖冲突问题

问题根源 #

Spring Boot 2.2.0.RELEASE绑定的Spring Framework版本为5.2.x，与你引入的5.3.27版本spring-web存在核心类依赖冲突：

• 高版本spring-web中的AllEncompassingFormHttpMessageConverter会自动尝试加载Jackson 2相关类，但Spring Boot 2.2.x默认依赖的Jackson 2.10.x与5.3.x版本的spring-web不兼容，导致NoClassDefFoundError。
• 即使配置Gson替代Jackson，AllEncompassingFormHttpMessageConverter的自动探测逻辑仍然会触发Jackson类的加载尝试，无法从根本上避免冲突。

可行解决方案 #

1. 隔离WebClient的独立上下文 #

不要让高版本spring-web的类与Spring Boot主上下文的类共享加载环境，手动创建一个独立的Spring上下文来初始化WebClient：

import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.client.WebClient;

// 独立的WebClient配置上下文，与主应用上下文隔离
@Configuration
public class WebClientConfig {
    @Bean
    public WebClient webClient() {
        return WebClient.builder()
                // 手动配置编解码器，避免依赖主上下文的HttpMessageConverter
                .codecs(configurer -> {
                    configurer.defaultCodecs().maxInMemorySize(16 * 1024 * 1024);
                    // 若需要，可手动添加Gson编解码器，跳过Jackson
                    // configurer.registerDefaults(false);
                    // configurer.customCodecs().register(new GsonHttpMessageConverter());
                })
                .build();
    }
}

// 在业务代码中初始化独立上下文并获取WebClient
public class WebClientHolder {
    private static final AnnotationConfigApplicationContext WEB_CLIENT_CONTEXT;
    private static final WebClient WEB_CLIENT;

    static {
        WEB_CLIENT_CONTEXT = new AnnotationConfigApplicationContext(WebClientConfig.class);
        WEB_CLIENT = WEB_CLIENT_CONTEXT.getBean(WebClient.class);
    }

    public static WebClient getWebClient() {
        return WEB_CLIENT;
    }
}

2. 排除主上下文的冲突自动配置 #

在Spring Boot启动类上排除与HttpMessageConverter相关的自动配置，阻止主上下文初始化会触发Jackson加载的Bean：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.http.HttpMessageConvertersAutoConfiguration;

@SpringBootApplication(exclude = {HttpMessageConvertersAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 替换冲突的FormHttpMessageConverter #

手动创建自定义的FormHttpMessageConverter，移除对Jackson转换器的探测逻辑，替换主上下文中原有的Bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.FormHttpMessageConverter;
import org.springframework.http.converter.HttpMessageConverter;

import java.util.ArrayList;
import java.util.List;

@Configuration
public class CustomHttpMessageConverterConfig {
    @Bean
    public FormHttpMessageConverter formHttpMessageConverter() {
        FormHttpMessageConverter converter = new FormHttpMessageConverter();
        // 手动设置支持的转换器，仅保留必要的，排除Jackson相关
        List<HttpMessageConverter<?>> partConverters = new ArrayList<>();
        // 添加你需要的转换器，比如StringHttpMessageConverter、GsonHttpMessageConverter等
        converter.setPartConverters(partConverters);
        return converter;
    }
}

4. 协调Jackson依赖版本 #

如果LDAP模块不依赖Jackson的特定版本，可以尝试升级Jackson依赖到与spring-web 5.3.27兼容的版本（推荐2.12.x及以上），解决类找不到的问题：

Maven示例：

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

注意事项 #

• 混用不同版本的Spring Framework模块存在潜在风险，部分内部API可能不兼容，建议优先测试核心业务流程（尤其是LDAP相关功能）。
• 隔离WebClient上下文的方式能最大程度降低冲突影响，是最稳妥的方案。

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