Android端报IllegalStateException,OkHttp调整后API无法正常调用
现存问题与已完成排查动作
- 应用运行过程中抛出
java.lang.IllegalStateException,异常提示为Expected Android API level 21+ but was 30 - 已尝试的调整及结果:
- 单独升级OkHttp依赖库版本,应用发生崩溃
- 单独降级OkHttp依赖库版本,应用同样发生崩溃
- 当前临时配置状态:将OkHttp版本固定为4.9.0后,上述崩溃问题不再出现,但存在接口请求无法正常发起调用的异常
可落地的解决思路
- 先理清报错根因:这个异常并非OkHttp本身与Android API 30不兼容,本质是项目依赖树中存在多版本OkHttp类冲突,类加载时加载到了远低于2.9.0版本的旧版OkHttp实现,旧实现内部的平台检测逻辑存在硬编码判断缺陷,在Android 30环境下误触发非法状态校验抛出异常。
- 全量清理依赖冲突:执行本地构建命令
./gradlew app:dependencies,在输出的依赖列表中过滤所有okhttp、okio相关条目,定位所有传递引入的非4.9.0版本OkHttp、与4.9.0不匹配的Okio依赖,在对应三方依赖的引入块中配置排除规则,将这类传递引入的旧版本依赖全部剔除,统一全局使用当前配置的4.9.0版本OkHttp,搭配适配的2.8.0版本Okio。 - 解决4.9.0版本下无法发起请求的问题:
- 统一OkHttpClient实例管理:不要在不同业务模块中重复实例化不同配置的OkHttpClient,全局初始化单例客户端复用到所有网络请求场景,避免类加载顺序错乱导致客户端初始化失败
- 检查网络基础配置:确认AndroidManifest.xml中正确声明
INTERNET权限,针对Android 9及以上系统的明文流量限制规则,按实际请求场景配置对应网络安全策略,确认目标请求域名没有被系统流量拦截规则阻断
- 避开无效试错:OkHttp 3.12.0及以上版本已完整兼容API21到最新版本的Android系统,不处理依赖冲突的前提下单纯升级/降级OkHttp版本,必然会触发依赖冲突类的崩溃,无法从根本上解决问题。
内容的提问来源于stack exchange,提问作者Dharmesh Prajapati
相关产品推荐
相关产品推荐

