JUnit 5所有断言方法均支持且强烈推荐添加自定义错误消息，如assertEquals(预期, 实际, "余额应为100元")，以提升失败日志可读性、准确定位问题并增强团队协作效率。

Java 单元测试中，所有 JUnit 5 的断言方法都支持添加自定义错误信息，这不是可选项，而是强烈推荐的实践。它能让测试失败时一眼看清“哪里错了、为什么错”，尤其在 CI/CD 流水线里省去大量排查时间。

带消息的断言写法

每个断言方法（如 assertEquals、assertTrue、assertThrows 等）都提供一个重载版本，把提示消息作为最后一个参数传入：

• assertEquals(预期值, 实际值, "余额应为100元")
• assertTrue(user.isActive(), "用户必须已激活")
• assertFalse(list.isEmpty(), "列表不应为空")
• assertNull(result, "查询结果应为空引用")
• assertThrows(NullPointerException.class, () -> obj.doSomething(), "空对象调用应抛NPE")

为什么消息不能省略

不加消息时，失败报错只显示类似 “expected but was ”，但你无法立刻判断这个 100 是余额、库存还是订单号。加上消息后：

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

• 报错直接显示：“余额应为100元” → 错误语义清晰
• 多个 assertEquals 共存时，能准确定位是哪一行没过
• 团队协作中，新成员看失败日志无需翻业务代码就能理解预期逻辑

异常断言中消息的进阶用法

使用 assertThrows 时，消息不仅用于断言本身，还可配合后续校验增强可读性：

• 先捕获异常实例：InsufficientBalanceException e = assertThrows(..., "取款超限应抛自定义异常")
• 再断言消息内容：assertEquals("余额不足:200.0", e.getMessage(), "异常消息格式不匹配")
• 甚至可用正则校验动态部分：assertThat(e.getMessage()).matches("余额不足:\d+\.\d+")

避免无效消息

消息要有信息量，不要写“断言失败”或“test failed”这类废话。好的消息应说明：

• 被测行为（如“登录时密码为空”）
• 预期状态（如“应拒绝登录并抛出 IllegalArgumentException”）
• 关键数据（如“实际输入：null”）

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南