Java开发中，equals()和hashCode()是对象比较与集合操作的核心基石。无论是使用HashSet去重，还是作为HashMap的键，这两个方法的正确实现都至关重要。本文将深入解析它们的底层原理、重写规则，并展示如何利用Lombok注解实现自动化生成。
一、核心原理：为什么必须成对重写？
1. equals() 的作用
equals()方法用于判断两个对象在逻辑上是否相等。默认情况下（继承自Object类），它比较的是对象的内存地址（即==）。当我们希望根据对象的属性值（如ID、名称）来判断相等性时，就需要重写此方法。
2. hashCode() 的作用
hashCode()返回对象的哈希码，主要用于哈希表（如HashMap、HashSet）的快速定位。它就像一个“数字指纹”，帮助集合快速缩小查找范围。
3. 黄金契约（Golden Rule）
Java规定了一个必须遵守的契约：
如果两个对象通过equals()比较返回true，那么它们的hashCode()必须返回相同的值。
为什么？
假设a.equals(b)为true，但a.hashCode() != b.hashCode()。当把这两个对象放入HashSet时：
集合会先根据hashCode将对象放入不同的“桶”（bucket）。
由于哈希码不同，集合会认为这是两个不同的对象，从而无法正确去重。
这会导致HashSet中出现逻辑上重复的元素，破坏集合的正确性。
二、手动重写：最佳实践与代码模板
1.重写 equals() 的步骤
1.检查自反性：如果是同一个对象，直接返回true。
2.检查类型：如果对象为null或类型不匹配，返回false。
3.类型转换：将参数转换为当前类型。
4.比较关键字段：逐一比较决定对象相等性的核心字段。
@Override
public boolean equals(Object o) {// 1. 地址相同，肯定是同一个对象if (this == o) return true;// 2. 类型检查：null或类型不同则不等if (o == null || getClass() != o.getClass()) return false;// 3. 类型转换User user = (User) o;// 4. 比较关键字段（使用Objects.equals处理null安全）return Objects.equals(id, user.id) && Objects.equals(name, user.name);
}
2. 重写 hashCode() 的步骤
必须使用与equals()中相同的字段来计算哈希码，以确保契约一致性。
@Override
public int hashCode() {// 使用Objects.hash自动组合字段哈希值return Objects.hash(id, name);
}
为什么选择Objects.hash？
Null安全：自动处理字段为null的情况。
质数组合：内部使用质数（如31）进行组合，能有效减少哈希冲突。
简洁性：一行代码替代繁琐的手动计算。
三、Lombok自动化：告别样板代码
手动重写虽然标准，但代码冗长且容易出错。Lombok提供了注解来自动生成这些方法。
1. 基础用法：@EqualsAndHashCode
在类上添加@EqualsAndHashCode注解，Lombok会自动生成基于所有非静态、非瞬态字段的equals和hashCode方法。
import lombok.EqualsAndHashCode;@EqualsAndHashCode
public class User {private String id;private String name;private int age;// Lombok会自动生成equals和hashCode，无需手动编写
}
2. 进阶配置：字段控制
有时我们不需要所有字段参与比较，Lombok提供了灵活的配置选项：
排除字段：使用exclude排除特定字段。
仅包含字段：使用of指定仅包含哪些字段。
// 方式1：排除age字段
@EqualsAndHashCode(exclude = "age")
public class User {private String id;private String name;private int age; // 不参与equals和hashCode计算
}// 方式2：仅包含id和name
@EqualsAndHashCode(of = {"id", "name"})
public class User {private String id;private String name;private int age; // 不参与计算
}
3. 继承场景：callSuper 陷阱
重要警告：当类存在继承关系时，必须特别注意callSuper参数。
默认行为：callSuper = false，生成的代码不会调用父类的equals和hashCode方法。
风险：如果父类有重要字段（如数据库主键id），子类对象可能会因为父类字段不同而被错误地判断为相等。
正确做法：
如果父类不是Object，且父类字段影响相等性判断，必须设置callSuper = true。
// 父类
public class BaseEntity {private Long id; // 数据库主键// ... getters/setters
}// 子类
@EqualsAndHashCode(callSuper = true) // 包含父类字段
public class User extends BaseEntity {private String name;
}
四、实战：Stream distinct() 去重原理
在文章开头的代码中，我们使用了stream().distinct()来去重。它的底层原理正是依赖equals和hashCode：
List<User> toList = createMessageReceivers(userUtil, deviceDO);
toList = toList.stream().distinct().collect(Collectors.toList());
底层机制：
HashSet去重：distinct()内部维护一个HashSet来记录已出现的元素。
先hash后equals：对于每个元素，先计算hashCode()定位到桶，如果桶内有元素，再调用equals()进行精确比较。
保留首次出现：重复的元素会被过滤掉，只保留第一次出现的那个。
为什么你的去重代码有效？
正是因为MessageReceiverVO类正确实现了equals和hashCode（无论是手动重写还是通过Lombok生成），distinct()才能根据对象内容而非内存地址进行去重。
五、总结与最佳实践
契约第一：重写equals必须重写hashCode，且基于相同字段。
工具优先：优先使用Objects.equals和Objects.hash，避免空指针和计算错误。
Lombok优化：使用@EqualsAndHashCode替代手动编码，但务必注意继承场景下的callSuper配置。
集合依赖：记住HashSet、HashMap和distinct()都依赖于这两个方法的正确实现。
通过掌握这些原理与工具，你就能轻松应对Java对象比较与去重的各种场景，写出既安全又高效的代码。