stream.distinct()对自定义对象去重需同时重写hashcode()和equals()方法，因其内部基于hashset实现，先通过hashcode分组再用equals精确比较；二者字段必须一致且满足契约，否则去重失效。
Stream.distinct() 去重看似简单，但对自定义对象生效的前提是：你必须正确重写 hashCode() 和 equals() 方法。否则，distinct() 会默认使用 Object 的实现，导致每个对象都被视为不同——即使字段值完全一样。
为什么 distinct() 需要 hashCode 和 equals？
Stream.distinct() 内部基于 HashSet 实现去重。HashSet 判断元素是否重复的逻辑是：
- 先调用对象的 hashCode()，快速分组（哈希桶）；
- 若哈希值相同，再调用 equals() 进行精确比对。
二者必须保持一致：如果两个对象 equals() 返回 true，它们的 hashCode() 必须相等；反之不强制。违反这点，HashSet 行为不可预测，distinct() 就会失效。
正确重写 equals() 和 hashCode() 的关键点
以一个常见的 User 类为例（含 id、name、age）：
- 只对参与“业务上是否相等”的字段重写：比如按 id 判定唯一性，那就只用 id；若 id + name 联合唯一，就都参与；不要把 createTime 或 status 这类非标识字段加进去。
- equals() 要满足对称性、传递性、一致性、非空性：用 Objects.equals(a, b) 安全比较字段，避免 NPE；开头加上 if (this == obj) return true; 和 if (obj == null || getClass() != obj.getClass()) return false;
- hashCode() 必须用和 equals() 相同的字段计算：推荐用 Objects.hash(field1, field2)，简洁且健壮。
实战代码示例（Java 17+）
假设我们希望按 user.id 去重：
<font size="2"><pre class="brush:php;toolbar:false;">public class User {
private Long id;
private String name;
private int age;
// 构造、getter 略
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
User user = (User) o;
return Objects.equals(id, user.id); // 只看 id
}
@Override
public int hashCode() {
return Objects.hash(id); // 和 equals 用同一字段
}
}
使用 Stream.distinct()：
<font size="2"><pre class="brush:php;toolbar:false;">List<user> users = List.of(
new User(1L, "Alice", 25),
new User(2L, "Bob", 30),
new User(1L, "Alicia", 26) // id 相同，应被去重
);
List<user> distinctUsers = users.stream()
.distinct()
.collect(Collectors.toList()); // 结果只有 2 个元素，重复 id 的第二个被过滤</user></user>
常见踩坑与验证技巧
- 只重写 equals() 不重写 hashCode() → 哈希桶错乱，distinct() 失效（最常见错误）。
- IDE 自动生成的 equals/hashCode 包含了不该参与比较的字段 → 逻辑不符合业务去重要求。
- 字段为 null 时未妥善处理 → equals 报 NPE，或 hashCode 计算异常。
- 验证方式：单独测试 new User(1,"a",10).equals(new User(1,"b",20)) 是否为 true；检查两者 hashCode() 是否相等。
