assertj通过assertthat()链式调用实现语义化断言，提升可读性、健壮性与失败信息清晰度；需添加依赖、静态导入，统一以assertthat(actual)开头，善用类型专属断言及as()添加上下文描述。

直接用 `assertThat()` 开头，链式调用语义化方法，就能写出读起来像句子一样的断言。 关键不在“能不能用”，而在于怎么组织才真正发挥 AssertJ 的优势：可读、健壮、失败信息清晰。

添加依赖和静态导入

先确保项目里有 AssertJ：

<dependency><groupid>org.assertj</groupid><artifactid>assertj-core</artifactid><version>3.24.2</version><scope>test</scope></dependency>

测试类顶部加上这行静态导入：

import static org.assertj.core.api.Assertions.*;

用 assertThat() 替代 assertEquals 等传统写法

不要写 assertEquals(expected, actual) 这类容易混淆期望/实际顺序的断言。统一用 assertThat(actual) 开头，后面接“你想验证什么”：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• assertThat(user.getName()).isEqualTo("Alice") —— 读作“断言用户名等于 Alice”
• assertThat(users).hasSize(3).containsExactly(user1, user2, user3)
• assertThat(response.getStatus()).isIn(200, 201)

善用类型专属断言提升表达力

AssertJ 会根据对象类型自动提供合适的方法，不用自己写 if 或循环：

• 字符串：startsWith("Error").contains("timeout").isNotBlank()
• 集合：extracting("name", "email").containsExactly("Alice", "alice@x.com")
• 时间：isBefore(LocalDateTime.now()).isCloseTo(now, within(2, SECONDS))
• 异常：assertThatThrownBy(() -> service.process(null)).isInstanceOf(NullPointerException.class).hasMessageContaining("input")

加 as() 描述上下文，让失败提示更精准

默认错误信息只告诉你值不对，加上 as() 能说明“为什么这个值重要”：

• assertThat(user.getRole()).as("用户注册后应默认为 USER 角色").isEqualTo("USER")
• assertThat(order.getTotal()).as("订单 %s 应收金额", order.getId()).isEqualTo(expectedAmount)

测试失败时，日志里会显示完整描述，排查更快。

不复杂但容易忽略。

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