升级Gradle至3.1.1后Android库失效问题求助

数据老陈

2026-5-26

解决Gradle 3.1.1升级后Android库运行时ClassNotFoundException问题

你遇到的这个问题，是Gradle版本升级后依赖传递或打包配置变化导致的典型场景——编译时依赖能被解析到，但运行时缺失特定类，在Gradle 3.x的依赖规则调整中很常见。下面是几个针对性的排查和解决步骤：

直接引入缺失类所在的依赖
com.google.android.gms.tasks.OnSuccessListener属于play-services-tasks库，如果你之前是通过其他Google Play Services依赖间接引入它的，Gradle 3.x的依赖解析逻辑可能截断了这个传递依赖。请在你的库模块build.gradle中直接添加该依赖：
```
// 替换为你项目中使用的Google Play Services对应版本
api 'com.google.android.gms:play-services-tasks:18.0.1'
```
注意implementation与api的区别
Gradle 3.0+引入的implementation会限制依赖的可见性，仅在当前模块内可用。如果你的库需要让依赖它的应用模块也能访问到OnSuccessListener类，必须把implementation替换为api，这样依赖才能向上传递。
排查混淆规则
如果你的项目启用了ProGuard或R8，可能混淆工具误删除了这个类。在proguard-rules.pro中添加保留规则：
```
-keep class com.google.android.gms.tasks.** { *; }
```
或者更精准地保留接口：
```
-keep interface com.google.android.gms.tasks.OnSuccessListener { *; }
```
清理Gradle缓存并重建
缓存异常也可能导致依赖加载不全，执行以下命令彻底清理后重建项目：
```
./gradlew clean build --refresh-dependencies
```
检查依赖版本一致性
确保项目中所有Google Play Services相关依赖的版本完全一致，版本冲突会导致部分依赖无法正常加载。比如同时使用play-services-auth和play-services-tasks时，两者版本号要统一。