本文介绍使用 Lombok 的 @EqualsAndHashCode 注解，为含嵌套对象的 DTO 生成一致性哈希值，支持通过 @EqualsAndHashCode.Exclude 精确排除 ID、版本等非业务字段，适用于数据库持久化场景。
本文介绍使用 lombok 的 `@equalsandhashcode` 注解，为含嵌套对象的 dto 生成一致性哈希值，支持通过 `@equalsandhashcode.exclude` 精确排除 id、版本等非业务字段，适用于数据库持久化场景。
在 Java 应用中，常需为复杂 DTO（如嵌套结构的领域对象）生成唯一哈希值用于缓存标识、变更检测或数据库去重存储。但标准 Objects.hash() 或手动重写 hashCode() 难以优雅处理字段级排除逻辑，尤其当对象存在多层嵌套（如 Car 包含 TyreClass）时，维护成本高且易出错。
Lombok 提供了简洁可靠的解决方案：@EqualsAndHashCode 注解可自动生成符合规范的 hashCode()（及 equals()），并支持细粒度控制——只需在待排除字段上添加 @EqualsAndHashCode.Exclude，即可自动忽略该字段及其递归引用链中的对应字段。
以下为完整实践示例：
import lombok.EqualsAndHashCode;
@EqualsAndHashCode
public class Car {
@EqualsAndHashCode.Exclude
private int id; // 数据库主键，不参与哈希计算
private int modelYear;
private String color;
private TyreClass tyre; // 嵌套对象，其 hashCode 将被自动纳入计算
}@EqualsAndHashCode
public class TyreClass {
@EqualsAndHashCode.Exclude
private int id; // 外键/临时ID，排除
@EqualsAndHashCode.Exclude
private int version; // 审计字段，排除
private float radius;
private String colour;
private double width;
}✅ 关键特性说明：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- @EqualsAndHashCode 默认包含所有非静态、非瞬态（non-transient）字段，并递归调用嵌套对象的 hashCode() —— 因此 Car.hashCode() 会自动包含 tyre.radius、tyre.colour 等有效字段；
- @EqualsAndHashCode.Exclude 可作用于任意层级字段（包括嵌套类中的字段），无需额外配置；
- 生成的哈希值为 int 类型，可直接转为十六进制字符串（如 Integer.toHexString(car.hashCode())）或 Base64 编码后持久化到数据库；
- 若需字符串哈希（如 SHA-256），建议将 toString() 或 JSON 序列化结果作为输入，但注意：Lombok 的 @ToString 同样支持 @ToString.Exclude，可保持字段排除逻辑一致。
⚠️ 注意事项：
- 确保被排除字段不参与业务语义一致性判断（例如 id 和 version 通常为技术字段，不影响对象业务等价性）；
- 所有参与哈希计算的字段必须是不可变的（immutable）或在哈希生成后不再修改，否则哈希值失效；
- 若 DTO 使用 Jackson 等序列化库，避免同时启用 @JsonIgnore 与 @EqualsAndHashCode.Exclude 造成语义混淆——二者目标不同：前者影响 JSON 输出，后者仅影响哈希逻辑；
- 生产环境建议配合 @RequiredArgsConstructor 或构造器校验，确保关键字段非空，提升哈希稳定性。
综上，Lombok 的 @EqualsAndHashCode 是实现嵌套 DTO 可控哈希生成的轻量级、零侵入方案，兼顾开发效率与运行时可靠性，特别适合需要将哈希值持久化至数据库的场景。
