兼容Spring 5.x与6.x：同一HttpClient代码能否编译通过？

一、Java实现编译时版本适配的方法 #

Java没有C语言那样的原生条件编译语法，但可以通过构建工具或编译工具实现类似的版本分支编译效果：

1. Maven/Gradle Profile 配置 #

通过构建工具的Profile功能，根据目标Spring版本切换依赖和编译代码目录：

• 代码结构上，将Spring 5.x和6.x的HttpClient实现分别放在src/main/java-spring5和src/main/java-spring6目录下
• Maven示例配置：

  <profiles>
      <profile>
          <id>spring5</id>
          <properties>
              <spring.version>5.3.28</spring.version>
              <httpclient.version>4.5.14</httpclient.version>
          </properties>
          <build>
              <sourceDirectory>src/main/java-spring5</sourceDirectory>
          </build>
      </profile>
      <profile>
          <id>spring6</id>
          <properties>
              <spring.version>6.0.11</spring.version>
              <httpclient.version>5.2.3</httpclient.version>
          </properties>
          <build>
              <sourceDirectory>src/main/java-spring6</sourceDirectory>
          </build>
      </profile>
  </profiles>
  

• Gradle可通过sourceSets和构建参数配置实现相同逻辑，编译时指定激活对应Profile即可生成适配对应Spring版本的包。

2. 编译时注解处理器 #

自定义注解处理器，在编译阶段读取Spring版本常量，动态生成适配版本的HttpClient实现类。这种方式实现成本较高，仅适合复杂的多版本兼容场景。

3. Java 9+ 模块系统（JPMS） #

通过模块的requires static指令，结合编译参数切换依赖版本，同时利用模块导出规则控制不同版本类的可见性。需要项目基于Java模块化开发。

二、其他跨版本兼容方案 #

除编译时适配外，还可通过代码抽象或运行时适配实现兼容：

1. 抽象适配层 #

定义统一的HttpClient操作接口，为Spring 5.x和6.x分别实现适配类：

// 统一抽象接口
public interface CustomHttpClientAdapter {
    ClientHttpRequestFactory createRequestFactory(int timeout) throws Exception;
}

// Spring 5.x适配实现
public class Spring5HttpClientAdapter implements CustomHttpClientAdapter {
    @Override
    public ClientHttpRequestFactory createRequestFactory(int timeout) throws Exception {
        HttpComponentsClientHttpRequestFactory factory = 
            new HttpComponentsClientHttpRequestFactory(buildHttpClient());
        factory.setConnectTimeout(timeout * 10000);
        return factory;
    }

    private org.apache.http.client.HttpClient buildHttpClient() throws Exception {
        SSLConnectionSocketFactory sslSocketFactory = 
            new SSLConnectionSocketFactory(createSSLContext());
        return HttpClients.custom().setSSLSocketFactory(sslSocketFactory).build();
    }
}

// Spring 6.x适配实现
public class Spring6HttpClientAdapter implements CustomHttpClientAdapter {
    @Override
    public ClientHttpRequestFactory createRequestFactory(int timeout) throws Exception {
        HttpComponentsClientHttpRequestFactory factory = 
            new HttpComponentsClientHttpRequestFactory(buildHttpClient());
        factory.setConnectTimeout(timeout * 10000);
        return factory;
    }

    private org.apache.hc.client5.http.classic.HttpClient buildHttpClient() throws Exception {
        SSLConnectionSocketFactory sslSocketFactory = 
            new SSLConnectionSocketFactory(createSSLContext());
        return HttpClients.custom().setSSLSocketFactory(sslSocketFactory).build();
    }
}

运行时通过类路径扫描或SPI机制，加载对应Spring版本的适配类。

2. 替换为Spring原生实现 #

如果对HttpClient功能要求不高，可直接使用Spring自带的SimpleClientHttpRequestFactory替代HttpComponentsClientHttpRequestFactory，完全避开Apache HttpClient的版本依赖问题。

3. 分版本维护分支 #

对于复杂度较高的项目，直接维护Spring 5.x和6.x两个独立分支，各自适配对应版本的依赖和API。这种方式最直接，避免兼容逻辑带来的额外复杂度。

内容的提问来源于stack exchange，提问作者Mikhail T.