Gradle本地项目依赖替换：带test classifier的模块替换失败求助

我在内部项目里做Gradle依赖替换，项目是Custom+Base的结构，Base包含核心功能，Custom可以覆盖Base的功能。之前替换其他内部库都没问题，但Base项目的主jar和test jar是分离的，替换时出了问题。

项目build.gradle的依赖配置：

implementation(group: "com.acme.widgets", name: "base", version: 1.0.0)
testImplementation(group: "com.acme.widgets", name: "base", version: 1.0.0)
testImplementation(group: "com.acme.widgets", name: "base", version: 1.0.0, classifier: "test")

settings.gradle里的依赖替换配置：

includeBuild('C:/local/project/Base'){
    dependencySubstitution {
        substitute module("com.acme.widgets:base:test") using project(':code:engine')
        substitute module("com.acme.widgets:base") using project(':code:engine')
    }
}

试了好几种配置组合，要么完全没替换效果，要么报“Could not find base-test.jar”错误。查了Gradle社区讨论和已关闭的GitHub Issue #3880，没找到可行的实操方案，只看到一些建议。有些案例只实现了带classifier的依赖替换，但没法同时保留主jar的替换。

想问下是我配置错了，还是Gradle目前不支持这种依赖替换？

解决方案 #

你的问题出在带classifier的模块匹配逻辑和本地项目产物的映射上，Gradle支持这种场景，但配置需要调整：

1. 修正依赖替换的classifier匹配规则
   之前用module("com.acme.widgets:base:test")的写法错误，module方法的第三个参数是版本号，不是classifier。正确的带classifier模块替换需要显式指定classifier参数：

   includeBuild('C:/local/project/Base') {
       dependencySubstitution {
           // 替换主jar依赖
           substitute module("com.acme.widgets:base") using project(':code:engine')
           // 替换带test classifier的test jar依赖
           substitute module("com.acme.widgets:base") with classifier("test") using project(':code:engine')
       }
   }
   

2. 确保本地Base项目能生成test classifier的jar
   本地项目默认只产出主jar，没有带test classifier的产物，替换后会出现找不到jar的错误。需要在Base项目的:code:engine模块build.gradle中配置生成test jar的任务：

   task testJar(type: Jar) {
       classifier = 'test'
       from sourceSets.test.output
   }
   
   configurations {
       testArtifacts
   }
   
   artifacts {
       testArtifacts testJar
   }
   

3. 简化testImplementation依赖（可选）
   主jar已经通过implementation传递到test环境，无需重复声明，可简化依赖配置：

   implementation(group: "com.acme.widgets", name: "base", version: 1.0.0)
   testImplementation(group: "com.acme.widgets", name: "base", version: 1.0.0, classifier: "test")
   

原因说明 #

• 错误的classifier匹配写法导致Gradle无法识别带test classifier的依赖，进而无法完成替换；
• 本地项目未配置生成带test classifier的jar产物，替换后Gradle找不到对应文件，抛出“Could not find base-test.jar”异常。

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