assertthrows用于验证代码是否抛出指定类型异常并获取异常实例以校验消息、状态码等细节,需用lambda延迟执行待测逻辑,避免提前抛出异常。

在 Java 的 JUnit 5 中,assertThrows 是专门用于验证代码是否**确实抛出了指定类型异常**的断言方法。它不仅能确认异常发生,还能获取异常实例,进而校验异常消息、状态码等细节,避免仅靠 try-catch 或 @Test(expected = ...)(JUnit 4)带来的校验盲区。
使用 assertThrows 基本语法
核心用法是传入期望的异常类型和一个函数式接口(Executable),执行被测代码块。若未抛出指定异常,测试直接失败。
-
assertThrows(Class<t> expectedType, Executable executable)</t>:只校验异常类型 -
assertThrows(Class<t> expectedType, Executable executable, String message)</t>:带自定义失败提示
示例:
Exception exception = assertThrows(NullPointerException.class, () -> {
userService.deleteUser(null); // 触发 NPE
});
这里不仅断言了异常类型,还把抛出的 NullPointerException 实例赋值给了 exception 变量,后续可进一步断言其内容。
校验异常消息是否匹配
仅检查类型不够严谨——比如空指针和参数校验都可能抛 IllegalArgumentException,需结合消息内容判断是否符合业务预期。
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- 调用
exception.getMessage()获取消息字符串 - 用
assertEquals或assertTrue(exception.getMessage().contains(...))校验
示例:
IllegalArgumentException e = assertThrows(IllegalArgumentException.class, () -> {
orderService.createOrder(new Order(null, 100));
});
assertEquals("订单编号不能为空", e.getMessage());
避免常见误用陷阱
assertThrows 的参数必须是“可执行动作”,不能直接传方法调用结果(否则异常会在断言前就被抛出,导致测试中断)。
- ❌ 错误写法:
assertThrows(..., service.doSomething())——doSomething()立即执行,异常无法被捕获 - ✅ 正确写法:
assertThrows(..., () -> service.doSomething())—— 包裹成 lambda 延迟执行 - 注意:lambda 内部不要加
try-catch,否则会吞掉异常,导致assertThrows判定失败
结合断言链做更完整的异常验证
对复杂业务异常(如自定义异常类),常需校验多个字段:消息、错误码、嵌套原因等。
- 先用
assertThrows获取异常实例 - 再用
assertInstanceOf确保是具体子类(如InsufficientBalanceException) - 接着断言
getCode()、getDetail()等业务字段
示例:
InsufficientBalanceException e = assertThrows(InsufficientBalanceException.class, () -> {
accountService.withdraw("A001", new BigDecimal("1000"));
});
assertEquals("BALANCE_INSUFFICIENT", e.getCode());
assertEquals(BigDecimal.valueOf(200), e.getAvailableBalance());
不复杂但容易忽略:关键在于把待测逻辑放进 lambda,再利用返回的异常对象做深度校验——这才是精确验证业务异常的可靠方式。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










