React Native集成WebSocket TrustManager时类重复构建报错排查
重复类冲突的核心根源
你遇到的checkDebugDuplicateClasses构建失败本质是OkHttp的版本历史代差导致的:
- OkHttp 3.5.0 之前版本的WebSocket能力是拆分为独立的
okhttp-ws模块发布的,3.5.0 及之后的版本已经把所有WebSocket相关实现(包括RealWebSocket、WebSocketProtocol、WebSocketReader、WebSocketWriter等okhttp3.internal.ws包下的类)直接合并进核心okhttp主包 - 你引入的
okhttp-ws:3.4.2是独立拆分时代的最后一个版本,内置了一整套完整的ws实现类,和项目里传递依赖进来的okhttp:3.14.1的类路径完全重叠,才会触发重复类检测
现有排除规则失效的原因
- 你之前为
okhttp-ws配置的排除规则,是试图从该依赖中排除okhttp主包,但冲突的类本身就打包在okhttp-ws的jar内部,不是okhttp主包和它重复,排除主包根本碰不到冲突根源 - 给Flipper网络插件配置的排除规则同理,只是移除了该插件传递引入的低版本
okhttp主包,没有解决okhttp-ws自身携带的重复ws实现类
可落地的适配修复方案
方案1:移除独立okhttp-ws依赖(最优解)
因为你要实现的带自定义TrustManager的WebSocket连接能力,完全可以直接用核心okhttp包内置的WebSocket API完成,不需要额外引入老版本独立模块:
- 从app模块的
build.gradle中删掉直接引入的okhttp-ws:3.4.2依赖行 - 参考公开Gist中的自定义TrustManager、自定义SSLSocketFactory逻辑,直接通过
OkHttpClient.Builder()配置对应安全参数,调用核心包内置的newWebSocket()方法建立连接即可 - 清理之前为该依赖配置的无效排除规则
方案2:兼容保留okhttp-ws依赖(临时方案)
如果部分老业务逻辑必须依赖老版本okhttp-ws的API,需要做全链路的版本对齐,不能仅在app模块配置排除规则:
- 在app模块的
build.gradle的android块下添加打包优先级规则,直接指定所有重复类优先使用核心okhttp包的实现,示例代码块:
android { // 保留原有android配置 packagingOptions { pickFirst 'okhttp3/internal/ws/RealWebSocket.class' pickFirst 'okhttp3/internal/ws/WebSocketProtocol.class' pickFirst 'okhttp3/internal/ws/WebSocketReader.class' pickFirst 'okhttp3/internal/ws/WebSocketWriter.class' // 把构建报错里列出的所有重复类按相同格式补充进列表 } }
- 在项目根目录的
build.gradle中添加全局依赖版本强制对齐规则,避免子模块传递引入带重复类的老版本okhttp-ws,示例代码块:
allprojects { repositories { // 保留原有仓库配置 } configurations.all { resolutionStrategy.force 'com.squareup.okhttp3:okhttp:3.14.1' // 强制对齐到3.14.1版本的okhttp-ws,这个版本是无实体类的空兼容包,不会引入重复实现 resolutionStrategy.force 'com.squareup.okhttp3:okhttp-ws:3.14.1' } }
容易遗漏的配置点
- 不要仅在app模块配置排除规则,React Native项目的很多三方SDK(Flipper、内置图片加载库、网络拦截器)会在独立子模块中传递引入okhttp相关依赖,只在app模块配置会漏掉跨模块的传递路径
- 不要手动删除Gradle缓存中的类文件,下次依赖同步时缓存会自动还原,还会破坏其他依赖的完整性校验
- 不要为了对齐okhttp-ws版本把项目整体的okhttp降到3.4.2,会触发Flipper、RN内置网络栈的版本不兼容,导致运行时崩溃
内容的提问来源于stack exchange,提问作者Vishal DS
相关产品推荐
相关产品推荐

