Gradle构建失败：Support v7/v4与AndroidX类重复冲突求助

这个问题我之前碰到好多次了，本质就是AndroidX和旧Support库的依赖冲突——Google推出AndroidX就是为了替代旧的Support库体系，两者的核心类完全重合但包名不同（旧的是android.support.*，新的是androidx.*），只要项目里同时混着这两类依赖，就必然会出现重复类的报错。

给你一套一步步的解决方法，按顺序来基本都能搞定：

1. 彻底迁移到AndroidX，移除所有旧Support库依赖 #

这是最根本的解决思路，不要想着同时兼容两者，直接全量迁移：

• 打开项目根目录的gradle.properties，确保这两个配置是true：

  android.useAndroidX=true
  android.enableJetifier=true
  

  解释下：useAndroidX让项目默认使用AndroidX的依赖；enableJetifier会自动把第三方库中隐藏的旧Support依赖转换成AndroidX版本，避免第三方库拖后腿。
• 打开app/build.gradle，把所有旧的Support依赖替换成对应的AndroidX依赖：
  • 比如原来的com.android.support:appcompat-v7:28.0.0替换成androidx.appcompat:appcompat:1.6.1
  • 原来的com.android.support:support-v4:28.0.0替换成androidx.legacy:legacy-support-v4:1.0.0
• 点击Android Studio右上角的「Sync Now」同步Gradle。

2. 排查并移除第三方库带来的隐藏依赖 #

如果同步后还是报错，大概率是某个第三方库偷偷引入了旧Support依赖，你可以用命令查看完整的依赖树：

./gradlew app:dependencies

在输出里搜索android.support关键词，找到哪个第三方库带了旧依赖，然后用exclude语法把它去掉：
比如发现com.example:third-party-lib:2.0引入了旧Support库，就修改依赖声明：

implementation('com.example:third-party-lib:2.0') {
    exclude group: 'com.android.support'
}

3. 清理项目缓存解决遗留问题 #

有时候缓存会导致一些奇怪的残留问题，这时候可以：

• 点击Android Studio菜单栏的「File -> Invalidate Caches...」，选择「Invalidate and Restart」重启IDE
• 手动删除项目根目录的.gradle文件夹和app/build文件夹，然后重新同步Gradle

最后提醒一句：千万别来回切换gradle.properties里的useAndroidX和enableJetifier开关，保持两者都为true是最稳妥的方式，也不要混合使用旧Support和AndroidX的依赖，彻底迁移才能从根源解决冲突。

内容的提问来源于stack exchange，提问作者Re.Thak