非哈希数据结构中是否需重写hashCode方法？仅重写equals是否足够？

你的假设不完全正确——即便你的类不会被用于HashMap、HashSet这类哈希数据结构，只要你重写了equals()方法，就必须同步重写hashCode()方法，原因如下：

1. 遵守Java官方规范的硬性约定 #

Java语言规范明确要求：

• 如果两个对象通过equals()方法比较返回true，那么它们的hashCode()方法必须返回相同的整数值；
• 如果两个对象的hashCode()返回值不同，那么equals()必须返回false。

这个约定不是仅针对哈希结构设计的，而是Java对象的核心行为准则。哪怕你现在不用哈希结构，也无法保证未来不会扩展代码，或者某些依赖这个约定的工具类、第三方库会间接用到对象的哈希码（比如部分集合工具方法、序列化相关操作等）。

2. 避免潜在的诡异bug #

如果只重写equals()而忽略hashCode()，一旦后续有人把这个类的实例放进哈希集合，会出现完全不符合预期的行为：

• 两个equals()相等的对象会被HashSet当成不同元素存储，破坏Set的唯一性；
• 在HashMap中存入对象后，无法通过相等的key取出对应的值，因为哈希码不一致导致找不到对应的桶。

这类bug很难排查，因为表面上业务逻辑完全正确，问题根源在于违反了Java的核心规范。

3. 保持代码的健壮性与一致性 #

重写equals()时同步实现hashCode()是Java开发的通用最佳实践。它能让你的代码更健壮，符合所有Java开发者的预期，避免因为规范缺失给后续维护带来麻烦。

反例演示 #

class User {
    private Long id;

    public User(Long id) {
        this.id = id;
    }

    // 仅重写equals方法
    @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);
    }

    // 未重写hashCode方法
}

public class Test {
    public static void main(String[] args) {
        User u1 = new User(1L);
        User u2 = new User(1L);
        
        System.out.println(u1.equals(u2)); // 输出true，符合预期
        HashSet<User> userSet = new HashSet<>();
        userSet.add(u1);
        userSet.add(u2);
        System.out.println(userSet.size()); // 输出2，违反Set唯一性的预期
    }
}

总结：无论你的类是否用于哈希数据结构，只要重写了equals()，就必须重写hashCode()——这是Java开发的基本准则，也是避免潜在问题的必要操作。

内容的提问来源于stack exchange，提问作者jayendra bhatt