Java中正确编写equals方法必须严格遵守五个契约：自反性、对称性、传递性、一致性、与null比较返回false；需先做null和类型检查（用==和instanceof），再逐字段用Objects.equals等安全比较，同步重写hashCode（用Objects.hash），并避开getClass()误用、非确定逻辑等陷阱。
Java 中正确编写 equals 方法，核心是严格遵守 五个契约（contract）：自反性、对称性、传递性、一致性、与 null 比较返回 false。只要漏掉任意一条，就可能引发难以排查的逻辑错误（如 HashMap 查不到对象、Set 重复添加等）。下面分要点说明怎么写才真正“满足所有契约”。
1. 先做 null 和类型检查（保底安全）
这是避免空指针和类型转换异常的第一道防线，也直接支撑“与 null 比较返回 false”这一契约：
- 用
==先判断是否为同一引用（含null == null成立，但obj == null时直接返回false） - 用
instanceof判断类型（推荐用instanceof而非getClass() ==，除非你明确禁止子类参与 equals —— 后者易破坏对称性） - 类型匹配后，再强转；不满足则立即返回
false
2. 逐字段比较，注意 null 安全和语义一致性
字段比较不是简单调用 == 或 .equals()，要结合字段类型处理：
- 基本类型（
int,boolean等）用== - 引用类型（如
String, 自定义对象）用Objects.equals(a, b)—— 它自动处理任一参数为null的情况，避免 NPE，且语义清晰 - 数组字段用
Arrays.equals(arr1, arr2)（注意：arr1.equals(arr2)是错的，它只比较引用） - 忽略不影响逻辑相等性的字段（如缓存、临时状态），但必须确保所有“业务上认为相同”的对象，这些字段组合值也一致
3. 同时重写 hashCode（契约强制要求）
equals 和 hashCode 必须同步维护。契约规定：如果两个对象 equals 返回 true，则它们的 hashCode 必须相等。否则放入 HashMap 或 HashSet 会出问题。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记（深入）”；
- 用
Objects.hash(field1, field2, ...)是最简洁可靠的方式，它自动处理null，且与Objects.equals使用的字段完全一致 - 不要在
hashCode中使用可变字段（如后期会修改的属性），否则对象加入哈希集合后修改字段，会导致再也找不到它
4. 避开常见陷阱（对称性/传递性杀手）
很多看似合理的写法，实际违反契约：
- ❌ 在子类中用
getClass() == obj.getClass()检查：会导致父类实例equals子类实例返回false，但子类实例equals父类实例也返回false—— 表面没问题，但如果父类重写了equals允许跨类型比较，而子类用getClass()就破坏对称性 - ❌ 在比较中引入额外逻辑（如忽略大小写、截断字符串、四舍五入数值）却不保证传递性：例如 A ≈ B（忽略空格）、B ≈ C（忽略空格），但 A 和 C 因其他差异不相等 → 违反传递性
- ❌ 在
equals中访问数据库、IO 或耗时计算：违反一致性（多次调用结果应相同），且严重损害性能
只要按这四点写，equals 就能稳定满足全部契约。关键是：类型检查用 instanceof、字段比较用 Objects.equals、hashCode 用 Objects.hash、不掺杂外部状态或不确定逻辑。
