Java 重寫 equals 為何不能直接比較 hashCode？深度解析哈希碰撞與契約

正確實作模板

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    MyClass that = (MyClass) o;
    return Objects.equals(field1, that.field1) &&
           Objects.equals(field2, that.field2) &&
           Double.compare(that.field3, field3) == 0;
}

@Override
public int hashCode() {
    return Objects.hash(field1, field2, field3);
}

hashCode 設計原則

• 包含所有參與 equals 比較的字段。
• 使用質數乘法擴大分佈（31 * result + field.hashCode()）。
• 避免可變字段參與計算，否則放入 HashMap 後修改字段導致找不到鍵值。

常見誤區

工具輔助

• IDE 自動生成 equals/hashCode（Alt+Insert → equals and hashCode）。
• Lombok @EqualsAndHashCode 註解自動實作。
• 單元測試驗證契約：EqualsVerifier.forClass(MyClass.class).verify();

嚴守契約、理解碰撞本質，是寫出健壯 Java 領域模型的基石。