线上Bug多因equals与hashCode未正确实现：必须同步重写二者，确保使用相同字段；equals需满足自反性、非空性、类型安全、字段安全比较及一致性；hashCode须保证相等对象返回相同值，数组字段需用Arrays.hashCode()；record类中数组字段需转List或手动实现。
线上 Bug 往往表现为：HashMap 查不到数据、HashSet 重复插入、缓存命中失败、对象去重失效——这些问题八成和 equals 与 hashCode 没写对有关。修复不靠猜，靠契约。下面直击关键动作。
检查是否只重写了 equals 而漏了 hashCode
这是最常见、最致命的疏漏。只要重写了 equals，hashCode 就必须同步重写，否则 HashMap/HashSet 的底层逻辑直接崩塌：
- 两个逻辑相等的对象，
equals返回true，但hashCode不同 → 它们被散列到不同桶里 →get()找不到，contains()返回false - 修复方式：立刻补上
@Override public int hashCode()，且确保它和equals使用**完全相同的字段集** - 别用
return 1;或return System.identityHashCode(this);应急——这等于没修
确认 equals 实现满足五大契约
哪怕只违反一条，集合行为就不可预测。逐条核对你的 equals 方法：
javascript-typescript-typescript-scaffold
下载
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
-
自反性：自己跟自己比必须返回
true→ 开头加if (this == obj) return true; -
非空性：传入
null必须返回false→ 加if (obj == null) return false; -
类型安全：用
getClass() != obj.getClass()判断，不用instanceof（避免子类比较破坏对称性） -
字段比较安全：所有参与比较的字段，用
Objects.equals(a, b)，自动处理null，不抛 NPE -
一致性：不依赖可变字段（如修改后会影响
equals结果的字段），否则对象进 HashSet 后再改字段，就再也找不到了
验证 hashCode 是否真正“一致且相等”
不要只看编译通过，要验证行为：
- 相等对象必须返回相同哈希值：构造两个字段完全相同的实例，断言
obj1.equals(obj2) && obj1.hashCode() == obj2.hashCode() - 推荐用
Objects.hash(field1, field2, ...)，简洁且能正确处理null和基本类型 - 如果含数组字段（如
int[] data），不能直接传给Objects.hash()→ 改用Arrays.hashCode(data)，否则内容相同的数组哈希值不同 - 如果是多维数组或嵌套结构，用
Arrays.deepHashCode()和Arrays.deepEquals()
记录类（record）也要小心数组字段
record 默认帮你生成 equals 和 hashCode，但对数组字段仍按引用比较：
- 比如
record Product(String name, int[] prices) { }→ 两个prices内容相同但地址不同的 record，equals返回false - 解决方案：把数组换成
List（List 的equals和hashCode是基于内容的） - 若必须用数组，就放弃 record，改写普通 class 并手动实现
equals/hashCode
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
