升级Android Gradle插件2.3.3至3.0.1遇字节码转Dex错误如何解决？

这是个特别常见的依赖冲突坑，你现在用排除Robolectric中Guava的方法虽然能临时解决，但还有几个更优雅、更可持续的方案，我整理了几个实用方向：

1. 统一全项目Guava版本（首选） #

最直接的解决方式就是强制所有依赖模块使用同一个兼容的Guava版本，从根源上避免不同版本的类重复打包。Gradle的resolutionStrategy可以帮你实现这一点：

在你的app模块或者根项目的build.gradle中添加配置：

configurations.all {
    resolutionStrategy {
        // 选择一个同时兼容主应用、Robolectric和仪器化测试的版本，推荐带-android后缀的Android优化版
        force 'com.google.guava:guava:28.1-android'
    }
}

选版本的时候注意：带-android后缀的Guava是专门为Android环境优化过的，会减少不必要的类，更适合移动端；如果Robolectric对版本有特殊要求，可以选一个双方都兼容的版本（比如27.0.1-jre很多Robolectric版本都支持）。

2. 精准定位冲突来源，针对性排除 #

有时候盲目排除Robolectric的Guava可能会影响测试稳定性，不如先搞清楚到底哪些依赖引入了冲突的Guava版本。你可以用Gradle的依赖分析命令：

# macOS/Linux
./gradlew app:dependencies

# Windows
gradlew.bat app:dependencies

在输出结果里搜索guava，就能看到所有引入Guava的依赖路径，比如如果发现仪器化测试里的某个第三方库也引入了旧版Guava，就可以只排除这个库的Guava，而不是动Robolectric的依赖：

androidTestImplementation('com.example:some-test-lib:1.0') {
    exclude group: 'com.google.guava', module: 'guava'
}

3. 启用Desugar工具（适配AndroidX项目） #

如果你已经迁移到AndroidX，AGP 3.0+支持的Desugar工具不仅能让项目支持Java 8特性，还能缓解部分依赖冲突导致的Dex问题，尤其是当不同版本Guava的差异只是字节码层面的小兼容问题时：

在app模块的build.gradle中配置：

android {
    compileOptions {
        coreLibraryDesugaringEnabled true
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.5'
}

4. 给不同环境分离依赖策略 #

如果统一版本后Robolectric出现运行异常（毕竟Robolectric对Guava版本有一定要求），可以给主应用、单元测试、仪器化测试分别指定适合的Guava版本，让各环境互不干扰：

// 主应用用Android优化版
configurations.implementation {
    resolutionStrategy.force 'com.google.guava:guava:28.1-android'
}

// Robolectric单元测试用JRE版
configurations.testImplementation {
    resolutionStrategy.force 'com.google.guava:guava:27.0.1-jre'
}

// 仪器化测试用Android版
configurations.androidTestImplementation {
    resolutionStrategy.force 'com.google.guava:guava:28.1-android'
}

总结 #

优先推荐统一全项目版本的方案，简洁高效；如果遇到模块兼容性问题，再用分离环境策略；依赖分析工具是排查问题的关键，能帮你避免盲目操作。

内容的提问来源于stack exchange，提问作者Jason Grife