如何为Android项目特定依赖组配置Gradle版本冲突失败检查？

要实现仅对指定依赖组触发版本冲突检查（而非全局启用failOnVersionConflict()），可以通过自定义依赖树遍历逻辑，精准检查目标组的依赖版本一致性，同时避免全局检查带来的性能损耗。

实现代码 #

afterEvaluate {
    // 替换为你需要检查的依赖组列表
    def restrictedGroups = ['com.google.guava', 'androidx.core', 'com.squareup.okhttp3']
    
    configurations.each { config ->
        // 仅处理可解析的配置
        if (config.canBeResolved) {
            try {
                def resolvedDeps = config.resolvedConfiguration.firstLevelModuleDependencies
                def dependencyVersionMap = [:]

                // 遍历直接依赖及其子依赖
                def traverseDeps = { dep ->
                    def depKey = "${dep.moduleGroup}:${dep.moduleName}"
                    if (restrictedGroups.contains(dep.moduleGroup)) {
                        if (!dependencyVersionMap.containsKey(depKey)) {
                            dependencyVersionMap[depKey] = new HashSet<>()
                        }
                        dependencyVersionMap[depKey].add(dep.moduleVersion)
                    }
                    // 递归处理子依赖
                    dep.children.each(traverseDeps)
                }

                resolvedDeps.each(traverseDeps)

                // 检查是否存在多版本冲突
                dependencyVersionMap.each { depKey, versions ->
                    if (versions.size() > 1) {
                        throw new GradleException("依赖版本冲突：${depKey} 发现多个版本：${versions.join(', ')}")
                    }
                }
            } catch (Exception e) {
                println "跳过无法解析的配置：${config.name}"
            }
        }
    }
}

代码说明 #

• 指定检查范围：通过restrictedGroups定义需要严格版本一致性的依赖组，按需添加或修改。
• 延迟执行：在afterEvaluate阶段执行，确保所有依赖配置完成后再进行检查，避免遗漏。
• 遍历依赖树：递归遍历直接依赖和间接依赖，覆盖所有可能引入冲突的路径。
• 冲突检测：对每个目标组的依赖，收集其所有出现的版本，若同一依赖（组+名称）存在多个版本，直接抛出构建异常并提示具体版本信息。
• 兼容处理：跳过无法解析的配置（如部分测试专用配置），避免不必要的构建中断。

优势对比 #

相比全局启用failOnVersionConflict()，该方案仅聚焦于你关心的依赖组，大幅减少依赖树遍历的计算量，在保证核心依赖版本一致性的同时，保留Gradle默认解析策略的性能优势。

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