Gradle Java项目为什么识别不到测试用例-java教程-PHP中文网

Gradle未识别test目录最常见原因是sourceSets.test.java.srcDirs配置错误或被覆盖，导致测试路径未被包含；需检查路径设置、类命名规范、依赖声明、task配置及IDE/Gradle缓存状态。

gradle java项目为什么识别不到测试用例

test目录没被Gradle识别为测试源集

最常见原因是 sourceSets.test.java.srcDirs 没正确指向你的测试代码路径，或者被意外覆盖。Gradle 默认只认 src/test/java，如果你的测试类放在 src/test/java/com/example/MyTest.java 但项目里写了 srcDirs = ['src/test/kotlin']，那 Java 测试就直接消失了。

检查方式：在终端运行 ./gradlew help --task test，看输出里 Source directories 是不是包含你预期的路径；或者执行 ./gradlew properties，搜索 test 和 sourceSets 相关字段。

多模块项目中，父项目的 subprojects{} 块可能统一重置了所有子模块的 test.srcDirs，比如加了 exclude '**/*Test.java' —— 这会把整个测试类都过滤掉，不是只过滤文件名匹配的类
用 Kotlin DSL（build.gradle.kts）时，srcDirs.set(listOf(...)) 会完全替换默认值，而 srcDirs += '...' 才是追加
IDE（如 IDEA）有时缓存了旧的源集配置，改完 build.gradle 后必须点 Reload project，否则编辑器里仍显示“test not included”

测试类命名或位置不符合默认约定

Gradle 的 Test task 默认只扫描满足以下任一条件的类：*Test、*Tests、Test*、*TestCase（注意大小写敏感）。如果你的类叫 mytest.java 或 ExampleIT.java（集成测试），又没显式配置 include，它就会被跳过。

另外，测试类必须在 sourceSets.test.java 声明的目录下，且包路径不能和 main 源集冲突（比如同时在 src/main/java 和 src/test/java 里放同名类，会导致编译失败或测试类被忽略）。

确认类名是否以大写 T 开头 + Test 结尾，例如 UserServiceTest ✅，userservicetest ❌
如果用了 @RunWith(SpringRunner.class) 或 JUnit 5 的 @ExtendWith，确保对应依赖已声明在 testImplementation 里，否则编译阶段就失败，根本到不了运行阶段
Android 项目或自定义 sourceSet（如 integrationTest）需单独配置 testTask，默认 test task 不会扫它们

build.gradle 中误删或覆盖了 test task 配置

有些团队为了禁用测试，会在根项目里全局关闭 test task：tasks.withType(Test).configureEach { enabled = false }。这种配置会穿透到所有子模块，即使子模块自己写了 test { enabled = true }，也会被父级覆盖（因为 Gradle 配置阶段是自顶向下执行的）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

另一个典型错误是把 test task 当成普通 task 重新定义，比如写了 task test(type: Test) { ... } —— 这会完全替换 Gradle 内置的 Test task，丢失所有默认行为（包括 classpath 构建、fork 配置、测试报告生成等）。

搜索整个项目，grep -r "enabled = false" . --include="*.gradle*"，重点看根项目的 allprojects 或 subprojects 块
避免重定义内置 task；如需定制，用 tasks.named('test') { ... } 或 test { ... } 语法
执行 ./gradlew tasks --all | grep test，确认 test task 状态是 Enabled 而非 Disabled