Gradle无冲突场景下如何强制触发模块替换且无需指定依赖版本

问题根因 #

你的问题存在两个核心影响点：

1. Gradle默认的模块替换规则确实仅在依赖冲突场景触发，无冲突时不会主动执行替换
2. 你当前collectLibs任务直接对未解析的Configuration做集合相减，此时模块替换逻辑还未执行，减的是原始依赖声明而非解析后的实际依赖

方案1：基于已解析的classpath筛选依赖（推荐） #

直接使用已经完成全量解析、已经应用了模块替换规则的runtimeClasspath做筛选，完全复用原有规则，不需要手动指定依赖版本，全程沿用BOM的版本管理能力，代码实现如下：

task collectLibs(type: Copy) {
    from configurations.runtimeClasspath.incoming.artifactView {
        componentFilter { componentId ->
            // 筛选仅属于lib配置、且不在provided配置中的组件
            def inLib = configurations.lib.allDependencies.any {
                it.moduleIdentifier == componentId.moduleIdentifier
            }
            def inProvided = configurations.provided.allDependencies.any {
                it.moduleIdentifier == componentId.moduleIdentifier
            }
            return inLib && !inProvided
        }
    }.files
    into "$buildDir/lib"
}

方案2：全局强制触发模块替换规则 #

如果你需要所有配置在任何场景下都主动执行模块替换，可以通过eachDependency钩子手动触发模块替换匹配，代码如下：

configurations.all {
    resolutionStrategy.eachDependency { details ->
        def replacement = project.dependencies.modules.moduleReplacements.find {
            it.from.moduleIdentifier == details.target.moduleIdentifier
        }
        if (replacement) {
            details.useTarget(replacement.to)
            details.because(replacement.reason)
        }
    }
}

添加这个配置后，所有配置解析时无论是否存在依赖冲突，都会主动应用你声明的模块替换规则，此时原来的configurations.lib - configurations.provided逻辑也可以正常生效。

方案3：无版本硬编码的依赖替换 #

如果更倾向于使用依赖替换实现，也可以不用硬编码版本，由于你已经引入了BOM管理版本，Gradle会自动从BOM中读取jakarta.annotation-api的对应版本，不需要手动指定版本号：

configurations.all {
    resolutionStrategy.dependencySubstitution {
        substitute module('javax.annotation:javax.annotation-api') using module('jakarta.annotation:jakarta.annotation-api')
    }
}

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