junit5 的 assertthrows 可干净可靠地测试自定义异常,支持校验异常类型、消息及业务字段;需确保异常类正确继承并提供相应构造器与 getter 方法。

直接用 JUnit5 的 assertThrows 就能干净、可靠地测试自定义异常,不用手写 try-catch,还能顺便校验异常消息和字段。
确认自定义异常已正确定义
确保你的异常类继承自 Exception 或 RuntimeException,有合适的构造器。例如:
- 继承
RuntimeException(非检查异常,调用方无需显式处理):
public InsufficientBalanceException(String message) {
super(message);
}
}
- 如果需要带业务字段(如错误码、账户ID),可额外添加私有字段和 getter 方法,方便后续断言。
用 assertThrows 断言异常类型
这是最核心的一步。传入异常类 + 待测行为的 Lambda 表达式,方法会返回捕获到的异常实例:
- 若代码没抛出该类型异常,测试立即失败
- 若抛出的是其他类型异常(比如
NullPointerException),测试也失败 - 返回的对象可继续用于消息或字段校验
void withdraw_shouldThrowInsufficientBalanceException_whenAmountExceedsBalance() {
Account account = new Account(100.0);
InsufficientBalanceException e = assertThrows(
InsufficientBalanceException.class,
() -> account.withdraw(200.0)
);
}
进一步验证异常内容
拿到异常对象后,可以像普通对象一样做断言:
- 检查完整消息:
assertEquals("余额不足:200.0", e.getMessage()) - 检查消息是否包含关键词:
assertTrue(e.getMessage().contains("余额不足")) - 用正则匹配更灵活的消息格式:
assertThat(e.getMessage()).matches("余额不足: \d+\.\d+")(需搭配 AssertJ) - 如果异常有自定义字段(如
errorCode),直接调用 getter 断言:assertEquals("ERR_BALANCE", e.getErrorCode())
避免常见错误
几个容易踩的坑要注意:
- 别把
assertThrows写成assertThrows(Exception.class, ...)—— 这样太宽泛,失去校验意义 - Lambda 里只放**可能抛异常的那一行或一小段逻辑**,不要塞进初始化、赋值等无关代码
- 不要在测试方法里自己 try-catch 然后 fail() —— 这种写法冗长且难调试,JUnit5 已提供更优解
- 确保被测方法确实会在该输入下抛出异常;否则测试会因“没抛出预期异常”而失败
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











