junit 5 测试跑不起来的核心原因是依赖与运行环境未对齐:需使用 org.junit.jupiter.api.test 注解、引入 junit-jupiter 和 junit-platform-surefire-provider 依赖、ide 配置为 junit 5 并清理缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

JUnit 5 测试类为什么跑不起来?@Test 报红或“no tests found”
常见现象是 IDE 显示 @Test 注解灰色、运行时报 No tests found matching Method xxx,或 Maven 执行 mvn test 时跳过测试。核心原因不是代码写错,而是依赖和运行环境没对齐。
- 确认用了 JUnit 5 的注解:必须是
org.junit.jupiter.api.Test,不是 JUnit 4 的org.junit.Test;混用会导致编译通过但运行不识别 - Maven 里要同时引入
junit-jupiter(含 API + engine)和junit-platform-surefire-provider(Maven Surefire 插件 >= 2.22.0 才原生支持 JUnit 5,旧版需显式配置 provider) - IDE 缓存常拖后腿:IntelliJ 要检查
Settings > Build > Testing > JUnit是否选中 “JUnit 5”,并执行File > Invalidate Caches and Restart
怎么测带 Spring Boot 依赖的 Service?@SpringBootTest 太重,@ExtendWith(MockitoExtension.class) 又报空指针
本质是测试粒度错配:@SpringBootTest 启整个上下文,适合集成验证;纯单元测试该用组合 Mock + 真实对象,但得手动控制依赖注入链。
- Service 构造器参数必须全被 mock 或真实构造——如果它依赖
UserService和RedisTemplate,你就得提供两个 mock 实例,不能只 mock 一个留一个 null - 别在测试方法里用
@Autowired:字段注入依赖于 Spring 容器,而@ExtendWith(MockitoExtension.class)不启动容器;改用构造器传参或Mockito.lenient().when(...)避免未 stub 方法触发 NPE - 若 Service 内部调用了
RestTemplate或JdbcTemplate,直接 mock 这些客户端比 mock 整个 service 更稳;例如用MockRestServiceServer拦截 HTTP 请求,而非 mock service 本身
覆盖率低是因为没测异常分支?assertThrows 怎么写才不漏边角 case
很多人只测正常流程,一遇到 IllegalArgumentException 就用 try-catch 包裹再 assert,这既啰嗦又容易漏掉异常消息校验。JUnit 5 的 assertThrows 是专治这个的,但用法有细节陷阱。
-
assertThrows返回的是实际抛出的异常实例,可以链式调用getMessage()或getCause()做断言,例如:assertThrows<nullpointerexception>(() -> obj.doSomething()).getMessage().contains("name")</nullpointerexception> - 别只断言异常类型:相同异常类可能在不同条件触发,比如
IllegalArgumentException可能因参数为 null 或长度超限,必须配合 message 或业务状态码验证 - 注意静态工具方法的异常:如
Objects.requireNonNull抛的是NullPointerException,但默认 message 是 "null",若你自定义了 message,就要对应写死断言,否则 CI 环境 locale 差异可能导致失败
Maven Surefire 插件跑覆盖率总是 0%?jacoco-maven-plugin 配置哪几项不能少
Jacoco 默认只织入 main 目录字节码,test 目录不参与覆盖率计算——所以即使你写了 100 个测试,报告里也显示 0%。关键不在测试数量,而在 agent 是否挂载到正确位置。
立即学习“Java免费学习笔记(深入)”;
- 必须启用
argLine:Surefire 插件需要通过 JVM 参数把 Jacoco agent 加进去,配置里缺<argline>${argLine}</argline>就等于没开开关 -
includes要明确指定包路径:例如<includes><include>com/example/**</include></includes>,否则默认只扫**/com/**,你的包名若含数字或下划线就可能被过滤 - 生成 report 前先确认
target/jacoco.exec文件存在且非空;如果为空,大概率是测试根本没执行(回到第一个副标题查依赖)或者 agent 没 attach 成功(检查 Maven 日志里有没有JaCoCo agent loaded)
覆盖率工具不会帮你发现逻辑漏洞,但会诚实暴露哪些 if 分支、哪些 catch 块从来没被执行过——盯着 MISSING_COVERAGE 行号补测试,比追着百分比数字改代码有用得多。










