Gradle 4多项目测试依赖问题：公共模块测试资源优先级异常

你碰到的这个问题其实是Gradle升级后依赖解析逻辑变化导致的——在2.x版本中，依赖项目的测试输出目录会排在主JAR之前，而4.x调整了类路径排序规则，让主项目的compile依赖（也就是common的主JAR）优先级更高，这就导致测试时加载的是main/resources里的配置文件，而非test/resources的。

之前你用的testOutput配置方案在旧版本有效，但新版本的类路径排序逻辑打破了这个预期。下面给出一个基于configuration的优雅解决方案，不用手动引用sourceSets：

步骤1：修改根build.gradle的全局配置 #

我们需要重新定义testOutput配置，确保它能正确传递测试输出，并且在被依赖时拥有更高的类路径优先级：

allprojects {
    plugins.withType(JavaPlugin) {
        configurations {
            testOutput {
                // 允许该配置被其他项目消费
                canBeConsumed = true
                canBeResolved = false
                // 将测试源集的完整输出（类+资源）作为该配置的产物
                outgoing.artifact(sourceSets.test.output) {
                    // 标记为目录类型，让Gradle在类路径排序时优先处理目录（JAR会排在目录之后）
                    type = "directory"
                }
                // 继承compile配置的依赖，确保测试代码能访问主代码的依赖项
                extendsFrom configurations.compile
            }
        }

        // 全局调整测试任务的类路径顺序，确保测试输出目录优先于依赖JAR
        test {
            classpath = classpath.sort { entry ->
                def path = entry.path
                // 优先放置当前项目的测试资源/类目录
                if (path.contains("/build/resources/test") || path.contains("/build/classes/test")) {
                    -2
                }
                // 然后放置依赖项目的测试输出目录
                else if (path.contains(":common") && (path.contains("/build/resources/test") || path.contains("/build/classes/test"))) {
                    -1
                }
                // 最后放置依赖JAR
                else if (entry.name.endsWith(".jar")) {
                    1
                }
                // 其他项保持原有顺序
                else {
                    0
                }
            }
        }
    }
}

步骤2：保持app/admin的依赖配置不变 #

你的app和admin项目的build.gradle不需要改动，依然使用原来的依赖声明：

dependencies {
    compile project(":common")
    testCompile project(path: ":common", configuration: "testOutput")
    // 其他依赖...
}

为什么这个方案有效？ #

1. 我们给testOutput配置的产物标记为directory类型，Gradle在处理类路径时，默认会让目录排在JAR之前，这样测试资源目录里的文件会优先被加载。
2. 全局的test任务排序逻辑进一步确保了依赖项目的测试输出目录排在其主JAR之前，彻底解决了资源覆盖问题。
3. 沿用了你熟悉的基于configuration的依赖方式，不需要在每个子项目里写evaluationDependsOn或者直接引用sourceSets，保持了配置的整洁性。

如果测试类路径顺序还是有问题，你可以通过执行./gradlew app:test --debug | grep "classpath"来验证排序是否符合预期，确保common的test输出目录在common.jar之前。

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