Lombok 的@EqualsAndHashCode 注解：你真的了解它的重要性吗？

关注

原创最新推荐文章于 2026-04-14 10:59:55 发布 1.2k 阅读 AI 写同款· GEO 优化 ›

我今天在写代码时遇到了一个问题：IDEA提示我需要在类上添加@EqualsAndHashCode(callSuper = true)注解。这个类继承了一个父类，而这个注解似乎和父类有某种关联。之前我只用过@EqualsAndHashCode，从未遇到过需要设置callSuper = true的情况。这让我有些困惑，为什么需要添加这个参数？它的作用到底是什么呢？如果不加的话会有什么问题？

为什么需要 `callSuper = true`？

在 Java 开发中，确保对象比较和哈希计算逻辑正确是十分关键的。特别是在使用继承关系时，如何让子类正确地继承父类的行为可能并不直观。

Lombok 提供的 @EqualsAndHashCode 注解用于自动生成 equals() 和 hashCode() 方法。默认情况下，这些方法只会基于当前类中的字段进行生成，而忽略父类的字段。那么，问题来了：如果父类中有一些关键字段，它们是否应该参与对象比较和哈希计算？

如果父类的字段对对象的相等性有影响，那么需要使用 @EqualsAndHashCode(callSuper = true)，以确保在生成的 equals() 和 hashCode() 方法中同时调用父类的 equals() 和 hashCode() 方法，继而比较父类的字段。

callSuper = false（默认）：只比较子类的字段，不调用父类的 equals() 和 hashCode() 方法。
callSuper = true：同时调用父类的 equals() 和 hashCode() 方法，确保继承的父类字段也被比较。

来看一个例子，演示 callSuper = false 时的问题。假设我们有一个父类 SuperClass，它有一个 id 字段用于标识对象，而子类 SubClass 有一个 field 字段。我们希望在对象比较时，子类的 field 和父类的 id 都应该参与比较。

但如果我们使用 callSuper = false，则比较逻辑只会基于子类的字段，父类的字段会被忽略。这就可能导致两个对象虽然 field 相同，但 id 不同的情况下，被错误地认为是相等的。

@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public class SubClass extends SuperClass {
    private String field;
}

@Getter
@Setter
public class SuperClass {
    private int id;
}

在上面的代码中，callSuper = false 意味着 SubClass 的 equals() 和 hashCode() 方法只会基于 field 字段进行比较，完全忽略了 SuperClass 的 id 字段。

public static void main(String[] args) {
    SuperClass obj1 = new SubClass();
    obj1.setId(1);
    ((SubClass) obj1).setField("test");

    SuperClass obj2 = new SubClass();
    obj2.setId(2);
    ((SubClass) obj2).setField("test");

    System.out.println(obj1.equals(obj2));  // 输出 true，尽管 id 不同
}

在这个例子中，尽管 obj1 和 obj2 的 id 字段不同，但由于 callSuper = false，只比较了子类 field 字段，导致两个对象被错误地认为相等。

什么时候需要 `callSuper = true`？

如果父类的字段对相等性判断有影响，那么就需要将这些字段纳入到比较中，这时就应该使用 @EqualsAndHashCode(callSuper = true)。尤其是在继承复杂对象时，父类中的状态信息很可能是相等性判断的一部分。

通常在子类中，如果父类的状态（字段）对相等性和哈希计算有影响，省略 callSuper = true 可能会导致比较不完整，潜在引发问题。比如，在 HashSet 或 HashMap 这类集合中，hashCode() 和 equals() 的正确性直接影响到对象的存储、查找和删除操作。忽略父类的字段，可能导致数据处理错误。

不使用 `callSuper = true` 的后果是什么？

如果不加 @EqualsAndHashCode(callSuper = true)，在继承父类的情况下，可能会在某些场景下引发问题，尤其是当父类的字段对对象的相等性和哈希值有重要影响时。

可能出现的问题：

忽略父类字段的比较，可能会引发一些隐藏的问题。例如，在使用 HashSet 或 HashMap 时，equals() 和 hashCode() 的行为不正确会导致数据无法正确插入、查找或删除。这类问题在集合操作中尤为常见，也会导致对象的唯一性判断失误。如：

HashSet 和 HashMap：这些基于 hashCode() 和 equals() 的集合操作会依赖这两个方法来判断对象的唯一性。如果 hashCode() 或 equals() 实现不完整，会导致对象插入、查找或删除操作异常。
TreeSet 或 TreeMap：这些集合在排序时也依赖比较方法，比较不完整会导致排序和逻辑错误。

数据丢失问题

如果子类实例序列化或反序列化时需要基于 equals() 和 hashCode() 做一致性检查，而这些方法没有考虑父类的字段，可能会导致数据处理的错误。

跨层级比较问题

如果在一个框架或模块中，某些比较逻辑要求完整考虑继承层次结构的所有字段，而你没有正确实现 equals() 和 hashCode()，可能会引发不可预期的行为。例如，在一些 ORM 框架或 Java Bean 比较时，这种问题会更容易暴露。

什么时候可以不用 `callSuper = true`？

当然，并不是所有情况都需要使用 callSuper = true。如果父类是一个无状态类，或者其字段不会影响对象比较，那么你可以选择不加这个注解。举个例子：

public class BaseEntity {
    private Long id;
}

@EqualsAndHashCode
public class Product extends BaseEntity {
    private String productName;
    private Double price;
}

在这个例子中，BaseEntity 的 id 字段可能只是数据库主键，用于标识而非用于比较。Product 类的相等性可能只取决于 productName 和 price，因此不需要加 callSuper = true。

此外，如果在比较或哈希计算时，父类的字段对结果没有任何影响，或这些字段的相等性不需要参与比较，那么也不需要加这个注解。例如，一些标识类或者仅用于子类行为扩展的父类，它们的字段不会影响子类对象的相等性判断。

在 IDEA 中，如果 Lombok 检测到你只覆盖了子类的 equals() 和 hashCode()，但没有包含父类字段，它会提醒你添加 callSuper = true 以确保完整性，但是不一定都要加上。