应使用JUnit等测试框架的语义化断言而非直接throw AssertionError;JUnit 5的assertEquals、assertTrue、assertAll及Lambda延迟消息可自动暴露关键变量值,提升失败定位效率。
assertionerror 本身不用于“记录”断言失败,而是由 jvm 在断言失败时自动抛出的异常;在 tdd 中,应使用测试框架(如 junit)的断言方法来表达逻辑,并让其自动报告失败详情——包括关键变量的实际值。
别直接 throw AssertionError,用 JUnit 的 assert 方法
Java 原生 assert 语句默认禁用,且不提供变量快照;TDD 中应依赖 JUnit(5+)等框架的语义化断言:
-
assertEquals(expected, actual)失败时自动打印expected和actual值 -
assertTrue(condition, "msg")支持自定义消息,可拼入变量:assertTrue(list.size() == 3, "Expected size 3, but got " + list.size()) - JUnit 5 的
assertAll()可批量检查并汇总多个变量状态
在失败消息中显式暴露关键变量值
清晰的失败信息 = 快速定位根源。避免空泛断言,把参与逻辑判断的变量显式写入消息:
- ❌
assertNotNull(result);→ 不知道 result 是什么、为何该非空 - ✅
assertNotNull(result, "User creation failed: returned null for input name='" + name + "'"); - ✅ 使用 Lambda 延迟求值(JUnit 5),避免无谓字符串拼接:
assertEquals(42, computedValue, () -> "Unexpected value when processing id=" + userId + ", config=" + config.toString());
配合日志或调试器,在断言前主动观察变量
AssertionError 是结果,不是观测手段。TDD 红-绿-重构循环中,可在测试代码中临时插入:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 打印关键中间值:
System.out.println("debug: user.age=" + user.getAge() + ", threshold=" + MIN_AGE); - 在 IDE 中对测试方法打条件断点(如
user.getAge() ),直接查看变量栈帧 - 用
Assertions.assertDoesNotThrow()包裹可疑逻辑,并在 catch 块中打印上下文
自定义断言工具类封装常用逻辑与变量输出
当某类校验高频出现(如金额精度、时间范围),可封装带上下文输出的静态方法:
立即学习“Java免费学习笔记(深入)”;
public static void assertMoneyEquals(BigDecimal expected, BigDecimal actual, String context) {<br> String msg = String.format("Money mismatch in %s: expected %s, got %s", context, expected, actual);<br> assertEquals(expected, actual, msg);<br>}- 调用:
assertMoneyEquals(new BigDecimal("19.99"), order.getTotal(), "checkout step"); - 好处:统一格式、复用上下文、便于后期替换为更详细的诊断逻辑


















