如何修复Android build.gradle中的依赖版本冲突问题？

Hey there, let's fix that annoying version conflict error you're seeing. The problem is exactly what the error states: all com.android.support libraries need to use the exact same version—mixing versions can trigger weird runtime crashes because different versions might have incompatible code or resource definitions. Here are three solid ways to resolve this:

1. 强制所有Support库使用统一版本（快速修复） #

最简便的方法是让Gradle自动覆盖所有冲突的Support库版本，统一使用你指定的版本。把这段代码添加到项目根目录的build.gradle中（不是模块级的build.gradle）：

allprojects {
    repositories {
        google()
        jcenter()
    }

    configurations.all {
        resolutionStrategy {
            // 强制所有com.android.support库使用同一版本
            eachDependency { DependencyResolveDetails details ->
                def requested = details.requested
                // 匹配所有com.android.support库，排除multidex相关
                if (requested.group == 'com.android.support' && !requested.name.startsWith('multidex')) {
                    // 推荐使用稳定版本，比如27.1.1，尽量避免alpha版本
                    details.useVersion '27.1.1'
                }
            }
        }
    }
}

建议优先选择稳定版本（比如27.1.1）而非28.0.0-alpha1这类预览版，因为预览版通常存在未修复的bug。

2. 定位并排除冲突依赖（精准修复） #

如果你想更精准地控制依赖，可以先找出是哪个第三方库引入了旧版本的Support库。在终端执行以下命令生成依赖树：

# Mac/Linux 环境
./gradlew app:dependencies

# Windows 环境
gradlew app:dependencies

在输出结果中查找类似com.android.support:cardview-v7:27.0.2的条目，记录下引入它的父依赖。然后在模块级build.gradle中排除该冲突模块：

dependencies {
    // 示例：从第三方库中排除冲突的cardview-v7
    implementation('com.example:some-third-party-lib:1.0.0') {
        exclude group: 'com.android.support', module: 'cardview-v7'
    }

    // 手动添加统一版本的cardview-v7
    implementation 'com.android.support:cardview-v7:27.1.1'
}

3. 迁移到AndroidX（长期解决方案） #

Google已经停止更新旧的Support库，转而推出了AndroidX——它从根本上解决了版本冲突问题，是长期维护项目的最佳选择：

1. 在gradle.properties文件中添加以下配置：

android.useAndroidX=true
android.enableJetifier=true

2. 将所有旧的Support库依赖替换为对应的AndroidX库，例如：
   • com.android.support:appcompat-v7:27.1.1 → androidx.appcompat:appcompat:1.0.0
   • com.android.support:cardview-v7:27.1.1 → androidx.cardview:cardview:1.0.0
3. 同步Gradle项目，Jetifier会自动将第三方依赖中的旧Support库转换为AndroidX版本。

小提示 #

除非特别需要新功能，否则尽量避免使用alpha/beta版本的库。稳定版本的可靠性更高，能减少意外问题的发生。

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