直接汇总多模块测试报告需显式定义聚合任务，因Gradle默认test任务不合并报告；各子项目独立生成HTML/XML报告，根项目无自动拉取机制；TestReport任务可聚合HTML，复制XML供CI使用；需注意ignoreFailures配置及同名测试类冲突问题。
直接汇总多模块测试报告是可行的，但不能靠默认的 test 任务自动合并——必须显式定义一个聚合任务。
为什么默认 test 不会生成汇总报告
Gradle 的每个子项目 test 任务独立运行，各自生成 HTML 和 XML 报告（路径如 subproject-A/build/reports/tests/test/），根项目不会自动拉取或合并。你执行 ./gradlew test 看到的只是所有子项目测试依次执行的日志，不是一份统一报告。
- 每个子项目的
test.reports.html.enabled = true是默认开启的，但只作用于自身 - XML 报告（JUnit 兼容格式）虽可被 CI 解析，但仍是分散在各子模块目录下
- 没有内置机制把多个
TEST-*.xml文件“拼成”一个逻辑报告
用 TestReport 类型任务聚合 HTML 报告
这是最常用、最轻量的汇总方式，适用于本地快速查看整体测试通过率与失败详情。
- 在根项目的
build.gradle（或build.gradle.kts）中添加： -
test任务本身不参与聚合，它只负责执行；真正干活的是新定义的testReport任务 - 必须关闭所有子项目的独立 HTML 报告，否则会重复生成且浪费磁盘
-
reportOn接收的是Test类型任务实例列表，不是字符串路径
task testReport(type: TestReport) {
destinationDir = file("$buildDir/reports/allTests")
reportOn subprojects*.test
}
然后执行：./gradlew testReport，结果会输出到 build/reports/allTests/index.html。
汇总 XML 报告供 CI 使用（如 Jenkins / GitLab CI）
CI 系统通常不关心 HTML，而是读取 TEST-*.xml 文件做趋势分析或失败归因。这时需要确保所有子模块都生成 XML，并集中存放或让 CI 扫描通配路径。
- 保持子项目
test.reports.junitXml.enabled = true（默认就是 true） - XML 文件默认生成在
subproject-X/build/test-results/test/TEST-*.xml - CI 工具配置时，用通配符匹配全部，例如：
**/build/test-results/test/TEST-*.xml - 如果 CI 不支持多路径扫描，可在根项目加个复制任务，把所有
TEST-*.xml拷贝到统一目录
注意 ignoreFailures 对聚合的影响
只要有一个子模块的 test 任务失败，默认情况下整个构建会中断，testReport 根本不会执行。
- 若想“即使部分测试失败也要出报告”，需在每个子项目的
test块里加：ignoreFailures = true - 或者更稳妥地，在聚合任务里显式允许失败：
reportOn subprojects*.test { ignoreFailures = true }（Groovy DSL 支持这种写法） - 注意：
ignoreFailures = true只影响报告生成流程，不掩盖问题——失败的测试仍会显示为 red，且 exit code 仍是 0，这点在 CI 中要格外小心
真正容易被忽略的是：聚合报告里的类名冲突问题。如果两个子模块里有同名测试类（比如都叫 UserServiceTest），TestReport 会把它们混在一起展示，无法区分归属模块。这不是 bug，而是设计使然——它只认类名和执行结果，不记录来源模块。需要靠命名规范或单独跑模块来定位。
