java单元测试断言库是精准描述代码行为是否符合预期的语言工具；junit 5 assertions提供数值/布尔校验、异常捕获、组合断言和自定义消息，assertj支持链式集合、字符串、对象断言并输出结构化差异，void方法需通过状态变更或mock验证副作用，应避免误用assert关键字、省略消息、混用风格及校验无关细节。
Java单元测试中，断言库不只是用来“判断相等”或“是否为真”，而是帮你精准描述“代码行为是否符合预期”的语言工具。用好它，能让测试更可靠、失败信息更清晰、维护成本更低。
用 JUnit 5 的 Assertions 做基础但扎实的校验
JUnit 5 自带的 Assertions 类覆盖绝大多数日常场景，语法简洁，无需额外依赖（test scope 下已默认可用）。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
数值与布尔校验：支持带误差容限的浮点比较，避免因精度问题误报失败
assertEquals(10.0, result, 0.001); -
异常捕获验证：明确断言某段逻辑必须抛出指定异常
assertThrows<font color="red">NullPointerException</font>.class, () -> service.process(null)); -
组合断言：一次执行多个检查，全部失败项都会报告，不因前一个失败而中断
assertAll(() -> assertEquals("A", user.getName()),<br> () -> assertTrue(user.isActive())); -
自定义失败消息：每个断言都建议加描述性消息，失败时一眼看懂上下文
assertTrue("用户积分应大于零", user.getPoints() > 0);
用 AssertJ 实现可读性强、错误信息全的链式断言
当业务逻辑变复杂，比如要校验集合内容、字符串格式、对象字段嵌套关系时，AssertJ 的链式 API 就显出优势了。
-
集合断言更自然：
assertThat(users).hasSize(3).extracting("name").contains("Alice", "Bob"); -
字符串校验更细致：
assertThat(message).startsWith("ERROR").contains("timeout").hasSizeGreaterThan(10); -
对象属性逐层验证：
assertThat(order).hasFieldOrPropertyWithValue("status", "PAID")<br> .extracting("items").asList().hasSize(2); - 失败时自动输出完整结构对比：比如 List 不匹配，会列出期望值和实际值的每一项差异，不用再手动打日志。
针对 void 方法或状态变更做间接断言
有些方法没有返回值，但会修改对象状态、写入数据库或触发事件。这时不能直接 assert 返回值，得靠“观察副作用”来验证。
- 调用 void 方法后，重新获取对象并断言其字段变化
service.updateUserStatus(user, ACTIVE);<br>assertThat(user.getStatus()).isEqualTo(ACTIVE);
- 配合内存仓库（如 H2）或 Mock，验证数据是否按预期存入
repository.save(order);<br>Optional<order> saved = repository.findById(order.getId());<br>assertThat(saved).isPresent().get().extracting("total").isEqualTo(199.99);</order> - 用 Mockito 验证方法是否被调用、参数是否正确
verify(emailService).send(eq("welcome@user.com"), contains("Welcome"));
避免常见误区，让断言真正起作用
-
不把断言当业务校验：生产环境不会启用 JVM 的
assert关键字，也不该在业务代码里用它替代if (x == null) throw new IllegalArgumentException()。 -
不省略消息参数：无消息的
assertTrue(condition)失败时只显示 true/false，无法定位是哪个条件、在哪种输入下出错。 -
不混合使用不同断言风格：一个测试类内尽量统一用 JUnit 5 或 AssertJ，避免
assertEquals和assertThat(...).isEqualTo(...)混用，影响可读性和团队协作。 -
不校验无关细节：比如测试 DTO 转换，重点是字段值和结构，不必断言
toString()输出格式——那是实现细节，易变且无业务意义。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
