Gradle中多库依赖同一外部库不同版本的报错问题

嘿，我看到你在更新项目外部库时碰到了Gradle多版本依赖冲突的报错，这种情况在Android开发里真的太常见了，别慌，咱们一步步来搞定它！

首先得搞懂问题根源：不同的第三方库依赖了同一个基础库的不同版本，Gradle默认情况下没法自动判定该用哪个版本，就会抛出冲突报错。接下来给你几个实用的解决办法：

1. 先精准定位冲突的依赖 #

要解决问题，得先知道到底是哪个库在搞事情。你可以打开Android Studio的Terminal，执行下面的命令：

# Mac/Linux用户
./gradlew app:dependencies

# Windows用户
gradlew app:dependencies

这个命令会生成完整的项目依赖树，你可以搜索冲突库的关键词（比如如果是Support库冲突就搜com.android.support），就能清楚看到哪些模块依赖了不同版本的同一个库。

2. 强制统一依赖版本 #

找到冲突的库之后，有两种高效的方式统一版本：

方式一：针对单个依赖强制指定版本 #

在你的app模块的build.gradle里，给冲突的依赖加上force关键字，强制所有引用该库的地方都用你指定的版本：

dependencies {
    // 你的其他正常依赖
    implementation 'com.android.support:appcompat-v7:28.0.0'
    
    // 强制所有模块使用这个版本的support-v4
    implementation ('com.android.support:support-v4:28.0.0') {
        force = true
    }
}

方式二：全局统一配置多个依赖 #

如果有一堆库都需要统一版本，更省心的方式是在app模块的build.gradle里添加全局配置：

configurations.all {
    resolutionStrategy {
        // 统一指定Support库版本
        force 'com.android.support:support-v4:28.0.0'
        force 'com.android.support:appcompat-v7:28.0.0'
        // 如果是Kotlin相关冲突，也可以统一版本
        force "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    }
}

这样所有依赖这些库的模块都会自动使用你指定的版本，不用一个个去改。

3. 升级过时的基础依赖 #

从你贴的项目build.gradle来看，你的Gradle插件版本是3.1.1，Kotlin版本是1.2.31，这些版本都比较老旧了，很可能是引发依赖冲突的诱因之一。建议你逐步升级到较新的稳定版本：

• Gradle插件可以升级到4.2.2（对应Gradle版本6.7.1），或者更高的稳定版
• Kotlin版本可以升级到1.5.31或者更适配当前Gradle的版本
  升级时记得同步Gradle，遇到兼容性提示跟着调整就行。

4. 用Android Studio自带工具一键解决 #

Android Studio有个超好用的依赖分析工具，你可以通过File > Project Structure > Dependencies进入，切换到Conflicts标签页，就能直观看到所有版本冲突的依赖，还能直接点击选择要统一的版本，一键搞定，不用手动写配置！

最后提醒下，修改完依赖后一定要点击Sync Now同步Gradle，然后执行Clean Project再重新编译，避免缓存残留导致的问题。

内容的提问来源于stack exchange，提问作者Joan P.S