本文介绍使用 Lombok 的 @EqualsAndHashCode 注解为含嵌套结构的 DTO 生成定制化哈希值，支持通过 @EqualsAndHashCode.Exclude 精确排除指定字段（如 ID、版本号等），输出 int 或 String 形式哈希，适用于数据库去重、变更检测等非比较场景。
本文介绍使用 lombok 的 `@equalsandhashcode` 注解为含嵌套结构的 dto 生成定制化哈希值，支持通过 `@equalsandhashcode.exclude` 精确排除指定字段（如 id、版本号等），输出 `int` 或 `string` 形式哈希，适用于数据库去重、变更检测等非比较场景。
在实际业务开发中，常需为复杂嵌套 DTO（如 Car 包含 TyreClass）生成唯一哈希值并持久化至数据库，用于记录快照、检测数据变更或实现轻量级缓存键。关键需求是：哈希应覆盖所有业务相关字段，同时自动忽略非业务字段（如主键 id、乐观锁 version），且无需手动编写冗长的 hashCode() 方法。
Lombok 是最契合该场景的成熟解决方案。它通过编译期注解自动生成符合 Java 规范的 hashCode() 和 equals() 方法，且天然支持嵌套对象递归哈希——只要被引用类型（如 TyreClass）自身也标注了 @EqualsAndHashCode，其参与哈希的字段即按规则自动纳入计算。
✅ 正确用法示例
import lombok.EqualsAndHashCode;
@EqualsAndHashCode
public class Car {
@EqualsAndHashCode.Exclude // 完全不参与哈希计算
private int id;
private int modelYear;
private String color;
private TyreClass tyre; // 自动递归调用 tyre.hashCode()
}@EqualsAndHashCode
public class TyreClass {
@EqualsAndHashCode.Exclude
private int id;
@EqualsAndHashCode.Exclude
private int version;
private float radius;
private String colour;
private double width;
}调用 new Car(...).hashCode() 即可获得整型哈希值；若需字符串形式（如存入数据库 VARCHAR 字段），可转为十六进制：
Car car = new Car(/* ... */);
int hashInt = car.hashCode();
String hashHex = String.format("%08x", hashInt & 0xffffffff); // 8位小写16进制，避免负号
// 示例输出: "a1b2c3d4"⚠️ 注意事项与最佳实践
- 必须为所有嵌套层级启用 @EqualsAndHashCode：若 TyreClass 未加该注解，Lombok 默认仅对 tyre 引用地址哈希（即 System.identityHashCode(tyre)），导致相同内容不同实例产生不同哈希，违背业务预期。
- 避免循环引用：若 Car 与 TyreClass 相互持有引用，需在任一端用 @EqualsAndHashCode.Exclude 打断，否则编译失败或运行时栈溢出。
- 字段可见性无关紧要：private 字段默认参与哈希，无需设为 public 或添加 getter。
- 不推荐用于安全敏感场景：Lombok 生成的 hashCode() 基于 Objects.hash(...)，属非加密哈希，不可用于签名或防篡改校验。
- 替代方案对比：Apache Commons Lang 的 HashCodeBuilder 虽灵活但需手写模板；Jackson 的 ObjectMapper 序列化后哈希易受字段顺序/空值处理影响，且性能开销大。
综上，Lombok 是兼顾简洁性、可靠性与可维护性的首选方案——仅需两个注解，即可让嵌套 DTO 的哈希逻辑清晰、零维护、零错误。
立即学习“Java免费学习笔记（深入）”；
