解决OkHttp多版本冲突问题记录

问题背景

在Java项目构建过程中，发现依赖树中存在多个OkHttp版本冲突：

• ​​okhttp-3.12.15.jar​​ (旧版)
• ​​okhttp-4.8.1.jar​​ (新版)

这种版本冲突会导致运行时不可预测的行为（如NoSuchMethodError），必须解决。

---

问题排查步骤

1. ​​依赖树分析​​
   执行Maven依赖树分析命令：

   mvn dependency:tree -Dverbose "-Dincludes=com.squareup.okhttp3:okhttp"

2. ​​关键输出发现​​

   [INFO] +- cn.uni.service:moduleA:jar:1.0.0
   [INFO] |  \- com.squareup.okhttp3:okhttp:jar:3.12.15:compile
   [INFO] \- org.example:libraryB:jar:2.0.0
   [INFO]    \- com.squareup.okhttp3:okhttp:jar:4.8.1:compile

   确认moduleA模块引入了冲突版本3.12.15

---

解决方案实施

1. 在依赖源头排除旧版本

<dependency>
  <groupId>cn.uni.service</groupId>
  <artifactId>moduleA</artifactId>
  <version>1.0.0</version>
  <exclusions>
    <exclusion>
      <groupId>com.squareup.okhttp3</groupId>
      <artifactId>okhttp</artifactId>
    </exclusion>
  </exclusions>
</dependency>

2. 全局版本控制（最佳实践）

在父POM中强制执行统一版本：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.squareup.okhttp3</groupId>
      <artifactId>okhttp</artifactId>
      <version>4.8.1</version> <!-- 强制使用新版 -->
    </dependency>
  </dependencies>
</dependencyManagement>

3. 使用Maven Enforcer插件

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-enforcer-plugin</artifactId>
  <version>3.1.0</version>
  <executions>
    <execution>
      <id>enforce-versions</id>
      <goals><goal>enforce</goal></goals>
      <configuration>
        <rules>
          <bannedDependencies>
            <excludes>
              <exclude>com.squareup.okhttp3:okhttp:3.12.15</exclude>
            </excludes>
          </bannedDependencies>
        </rules>
      </configuration>
    </execution>
  </executions>
</plugin>

---

版本兼容性对照

特性	3.12.15	4.8.1
​​最低JDK​​	1.7	1.8+
​​Android​​	5.0+ (API 21)	8.0+ (API 26)
​​HTTP/2​​	实验性支持	完全支持
​​维护状态​​	停止维护	积极更新

新版OkHttp 4.x系列全面迁移至Kotlin，建议优先使用4.8.1版本

---

验证结果

重建依赖树确认冲突消除：

mvn dependency:tree -Dincludes=com.squareup.okhttp3:okhttp

# 输出结果：
[INFO] \- com.squareup.okhttp3:okhttp:jar:4.8.1:compile

---

经验总结

1. ​​依赖检查原则​​

   • 使用mvn dependency:tree定期检查依赖树
   • 在持续集成流程中添加依赖检查步骤

2. ​​冲突预防策略​​

   graph TD
   A[多模块项目] --> B[父POM声明dependencyManagement]
   B --> C[子模块继承版本]
   C --> D[构建时自动统一版本]

3. ​​关键决策点​​

   • 优先通过<dependencyManagement>统一版本
   • 临时解决方案使用<exclusions>排除
   • 使用maven-enforcer-plugin阻止意外引入旧版本