如何在Gradle中配置依赖回退？找不到指定依赖时自动切换备选依赖

可以在Gradle中实现指定依赖缺失时的自动回退逻辑，下面给出两种主流DSL的具体配置方式：

Groovy DSL 配置 #

在项目的build.gradle文件中添加以下配置：

configurations.all {
    resolutionStrategy {
        // 定义依赖替换规则：当主依赖无法解析时，自动切换到回退依赖
        dependencySubstitution {
            substitute module('com.example.module:artifact:version') using module('com.example.fallback_module:fallback_artifact:fallback_version')
        }
        
        // 配置构件选择规则，仅当主依赖确实无法找到时触发替换
        componentSelection {
            all { selection ->
                def target = selection.candidate
                if (target.group == 'com.example.module' && target.name == 'artifact' && target.version == 'version') {
                    try {
                        // 尝试解析主依赖的描述符，失败则触发替换
                        selection.descriptor
                    } catch (Exception e) {
                        selection.reject("主依赖不可用，切换至回退依赖")
                    }
                }
            }
        }
    }
}

// 正常声明主依赖
dependencies {
    implementation 'com.example.module:artifact:version'
}

Kotlin DSL 配置 #

如果使用Kotlin编写构建脚本（build.gradle.kts），配置如下：

configurations.all {
    resolutionStrategy {
        dependencySubstitution {
            substitute(module("com.example.module:artifact:version")) using module("com.example.fallback_module:fallback_artifact:fallback_version")
        }
        
        componentSelection {
            all {
                val target = candidate
                if (target.group == "com.example.module" && target.name == "artifact" && target.version == "version") {
                    runCatching { descriptor }.onFailure {
                        reject("主依赖不可用，切换至回退依赖")
                    }
                }
            }
        }
    }
}

dependencies {
    implementation("com.example.module:artifact:version")
}

关键说明 #

• 上述配置会先尝试解析主依赖com.example.module:artifact:version，当所有指定仓库均无法找到该构件时，自动替换为回退依赖。
• 需确保回退依赖与主依赖的API兼容，避免因替换导致代码编译或运行时错误。
• 如果需要针对特定配置（如仅implementation）生效，可将configurations.all替换为目标配置名称（如configurations.implementation）。

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