在 java 单元测试中，使用 assertequals 断言相等时，应调用测试框架提供的静态方法，将期望值作为第一个参数，实际值作为第二个参数。该方法内部会调用对象的 equals() 方法来比较两个对象是否逻辑相等，若不相等则抛出 assertionerror 终止测试。对于基本类型，它会自动装箱进行比较；对于集合或数组，需确保其 equals() 实现符合预期，否则建议使用专门的集合断言方法。
assertEquals 处理字符串与自定义对象时的行为差异是什么
当断言对象为 String 或实现了正确 equals() 的自定义类时，assertEquals 能准确判断内容一致性；但若断言的是未重写 equals() 的普通对象，它将退化为引用地址比较（即 == 的效果），导致即使内容相同也会报错。因此，必须确保被测类的 equals() 和 hashCode() 已正确实现，或使用 isEqualToComparingFieldByField() 等深度比较工具。
import static org.junit.jupiter.api.Assertions.assertEquals;
public class User {
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof User)) return false;
User user = (User) o;
return age == user.age && name.equals(user.name);
}
}
// 测试用例
User expected = new User("Alice", 30);
User actual = new User("Alice", 30);
assertEquals(expected, actual); // 通过，因为重写了 equals
断言浮点数或高精度数值时为何不能直接用 assertEquals
由于浮点数运算存在精度丢失问题，直接使用 assertEquals 比较两个 double 或 float 值极大概率会失败。正确的做法是使用带有容差值（delta）的重载版本 assertEquals(expected, actual, delta)，或者使用 BigDecimal 进行精确计算后再断言。Delta 表示允许的最大误差范围，只有当 |expected - actual|
立即学习“Java免费学习笔记（深入）”；
import static org.junit.jupiter.api.Assertions.assertEquals;
// 错误示例：可能因精度问题失败
double a = 0.1 + 0.2;
double b = 0.3;
assertEquals(b, a);
// 正确示例：指定容差
equals(0.3, 0.1 + 0.2, 0.00001);
// 高精度场景：使用 BigDecimal
equals(new BigDecimal("0.3"), new BigDecimal("0.1").add(new BigDecimal("0.2")));
当 assertEquals 失败时，如何获取详细的差异信息以辅助调试
现代测试框架（如 JUnit 5、TestNG）在 assertEquals 失败时，默认会在异常消息中提供期望值与实际值的对比摘要。为了获得更清晰的调试信息，建议在调用时传入第三个参数作为自定义失败消息，例如 assertEquals(expected, actual, "用户ID不匹配")。此外，对于复杂对象，可结合 assertThat（Hamcrest 风格）或 isEqualToComparingFieldByField 来获取逐字段的差异报告，从而快速定位是哪个属性导致了不等。
