Gradle如何在外部依赖文件变更时强制重跑测试且保留缓存能力

Gradle 的测试缓存完全基于 Test 任务的*输入项(inputs)和输出项(outputs)*哈希值比对，只要把需要关联的外部文件注册为测试任务的输入，这些文件的内容变更就会被纳入缓存校验逻辑，触发对应测试的重跑，不会复用旧缓存。

具体实现方案 #

1. 直接指定跨模块依赖的固定路径文件 #

如果依赖的是其他模块的固定路径配置文件/资源文件，直接在测试所属模块的 build.gradle （Groovy 语法）或 build.gradle.kts （Kotlin DSL 语法）中对 Test 任务添加输入项配置即可：

Groovy 语法示例

test {
    // 示例：依赖根目录下 common 模块 config 文件夹下的所有 yml 配置文件
    inputs.files project.rootProject.file("common/src/main/resources/config/")
        .withPropertyName("commonConfigFiles")
        .withPathSensitivity(PathSensitivity.RELATIVE)

    // 也可指定单个文件，示例：依赖 auth 模块的 application.yml 配置
    inputs.file project.rootProject.file("auth/src/main/resources/application.yml")
        .withPropertyName("authConfigFile")
        .withPathSensitivity(PathSensitivity.RELATIVE)
}

Kotlin DSL 语法示例

tasks.test {
    // 示例：依赖 common 模块的 config 目录
    inputs.files(rootProject.file("common/src/main/resources/config/"))
        .withPropertyName("commonConfigFiles")
        .withPathSensitivity(PathSensitivity.RELATIVE)
    
    // 单个文件示例：依赖 auth 模块的 application.yml 配置
    inputs.file(rootProject.file("auth/src/main/resources/application.yml"))
        .withPropertyName("authConfigFile")
        .withPathSensitivity(PathSensitivity.RELATIVE)
}

参数说明：

• withPropertyName：给当前输入项设置唯一标识名，避免和其他输入项冲突
• withPathSensitivity：指定路径敏感度，跨模块文件使用 RELATIVE 即可，只要文件内容和相对路径不变就不会触发测试重跑

2. 关联其他模块的资源输出（多模块项目推荐） #

如果依赖的是其他模块构建后输出的资源文件，直接关联对应模块的 processResources 任务输出，更符合 Gradle 的任务依赖逻辑，可避免出现资源文件还没生成就提前执行测试的问题：

Groovy 语法示例

// 测试所属模块的 build.gradle 配置
test {
    // 依赖 common 模块 processResources 任务输出的所有资源
    inputs.files project(":common").tasks.processResources
        .withPropertyName("commonModuleResources")
        .withPathSensitivity(PathSensitivity.RELATIVE)
}

Kotlin DSL 语法示例

tasks.test {
    inputs.files(project(":common").tasks.processResources)
        .withPropertyName("commonModuleResources")
        .withPathSensitivity(PathSensitivity.RELATIVE)
}

验证配置效果 #

配置完成后可通过以下步骤验证缓存逻辑是否生效：

1. 首次执行测试：./gradlew test，测试正常执行，结果写入缓存
2. 不修改任何内容二次执行测试：./gradlew test，测试任务显示 UP-TO-DATE，成功复用缓存
3. 修改已关联的配置文件内容后执行测试：./gradlew test，测试任务重新执行，不会复用旧缓存

可选配置：仅为部分测试关联依赖文件 #

如果只有指定测试类需要关联这些外部文件，可以单独创建自定义 Test 任务，避免所有测试都受影响：

// 测试所属模块 build.gradle 配置
task specialTest(type: Test) {
    // 仅运行 com.example.config 包下的测试类
    include "com/example/config/**"
    // 关联依赖的配置文件
    inputs.files project(":common").tasks.processResources
        .withPropertyName("commonModuleResources")
        .withPathSensitivity(PathSensitivity.RELATIVE)
}
// 全局 build 任务自动执行该自定义测试任务
build.dependsOn specialTest

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