Gradle多模块项目中主模块精确排除子模块测试类

本文要聊的是一个在 Gradle 多模块项目中非常实用的技巧：当模块 A 通过 compile project(':B') 依赖模块 B 时，如何让 ./gradlew test（针对 A）不触发 B 中特定测试类的执行。关键点在于理解 Gradle 测试任务的作用域，以及如何通过跨模块任务依赖和自定义测试任务实现精准控制。

先搞清楚一个核心概念：Gradle 中的 test 是一个项目级任务。当你执行 ./gradlew test 时，Gradle 会在所有参与构建的子项目（包括 A 和 B）中并行执行各自的 test 任务。所以，如果你只在模块 A 的 build.gradle 里配置 test { excludes = [...] }，那是没用的——它只影响 A 自身的测试类扫描路径，对 B 的 test 任务毫无影响。你之前尝试的 excludes = ["B/src/test/**"] 之所以不生效，正是因为 excludes 是针对当前项目 src/test 目录下的类路径过滤，而不是跨项目文件系统路径匹配。

正确解决方案：分场景选择策略

方案一：避免运行 B 的测试（推荐，最简洁）

最简单直接的办法：如果模块 A 的测试根本不需要触发 B 的任何测试，那就直接限定目标项目执行：

./gradlew A:test

这条命令只会跑 A 的 test 任务，B 的测试完全不会触发。零配置，零副作用，适用于绝大多数集成隔离场景。

方案二：有选择地运行 B 的部分测试（需定制化控制）

如果业务逻辑要求模块 A 的测试流程中必须执行模块 B 的部分测试（比如共享工具类验证），但需要排除特定类，那就要在模块 B 中定义一个专用测试任务，并在 A 中显式依赖它。

1. 在模块 B 的 build.gradle 中定义自定义测试任务：

   // 模块 B/build.gradle
   tasks.register('selectiveTest', Test) {
       // 显式指定测试源集（确保使用 B 的测试代码）
       testClassesDirs = sourceSets.test.output.classesDirs
       classpath = sourceSets.test.runtimeClasspath
   
       // 排除指定测试类（支持通配符）
       exclude '**/IntegrationSmokeTest.class'
       exclude '**/LegacyApiTest.class'
       // 或按包排除
       exclude 'com.example.b.legacy.**'
   
       // 可选：启用测试过滤（更灵活）
       include '**/Unit*Test.class'
   }

2. 在模块 A 的 build.gradle 中覆盖默认依赖关系：

   // 模块 A/build.gradle
   test {
       // 移除对 B:test 的隐式依赖（Gradle 默认行为）
       dependsOn.remove('B:test')
       // 改为依赖 B 的定制任务
       dependsOn 'B:selectiveTest'
   }

需要警惕的是：

• exclude 接收的是 class 文件路径模式（编译后路径），不是源码路径（如 src/test/ja va/...）。务必使用 **/ClassName.class 或 com/package/** 格式。
• 如果使用 Kotlin DSL（build.gradle.kts），语法要调整成 exclude("com/example/b/**")。
• 不要写 B/src/test/** 这种无效路径——Gradle 不解析跨项目源码目录。
• 验证效果：执行 ./gradlew A:test --info，观察日志中是否出现 Executing task ':B:selectiveTest' 及被排除类的跳过提示。

总结

Gradle 的测试执行模型是基于项目边界的，跨模块测试控制必须通过任务依赖显式编排，而不是路径式排除。优先采用 A:test 命令实现天然隔离；如果需要深度协同，就通过 register() 创建可复用的定制测试任务，并用 dependsOn 精准串联。这种设计既符合 Gradle 的声明式构建哲学，也能保障多模块测试策略的可维护性和可追溯性。