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

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 里放同名类，会导致编译失败或测试类被忽略）。

立即学习“Java免费学习笔记（深入）”；

java-api-doc-generator

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

下载

• 确认类名是否以大写 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 配置阶段是自顶向下执行的）。

另一个典型错误是把 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

IDE 缓存或 Gradle daemon 混淆了源集状态

IDEA 有时会把 src/test/java 标记为 “Excluded”，尤其在多模块项目中手动拖拽过文件夹后；Gradle daemon 则可能缓存了旧的 sourceSet 结构，导致 ./gradlew test 也读不到新添加的测试类。

这不是配置问题，而是状态不一致。比如你刚加了一个模块，IDE 没刷新，Gradle daemon 还记得上一次构建时那个模块不存在。

• IDEA 中右键 src/test/java → Mark as Test Sources Root（确保图标是绿色小箭头）
• 执行 ./gradlew --stop 杀掉所有 daemon，再跑 ./gradlew test --no-daemon 验证是否恢复
• 删掉项目根目录下的 .gradle 和各模块下的 build 目录，强制重新解析源集（耗时但最彻底）

真正卡住人的地方，往往不是“怎么加测试”，而是“谁悄悄删掉了测试”。父项目的 subprojects 块、IDE 的自动标记、甚至某次 merge conflict 时误删的 test { include '**/*Test.class' }，都会让测试无声消失。