如何为所有JPA实体统一重写equals和hashCode方法？

方案1：修正@MappedSuperclass继承方案 #

你之前用@MappedSuperclass没成功，大概率是实现逻辑有问题，正确的写法应该聚焦基于数据库主键（ID）实现，同时处理未持久化（ID为null）的场景：

1. 定义带@MappedSuperclass的基类：

import jakarta.persistence.*;
import java.io.Serializable;

@MappedSuperclass
public abstract class BaseEntity implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        BaseEntity that = (BaseEntity) o;
        // 未持久化时用内存地址判断，避免同一会话中新建实体被误判为相等
        return id != null && id.equals(that.id);
    }

    @Override
    public int hashCode() {
        // 未持久化时用Object原生hashCode，持久化后用ID的hashCode
        return id != null ? id.hashCode() : super.hashCode();
    }
}

2. 实体类直接继承即可：

import jakarta.persistence.Entity;

@Entity
public class MyEntity extends BaseEntity {
    // 你的业务字段，比如：
    private String name;

    // 业务字段的getter、setter
}

如果是复合主键，只需把基类逻辑改成基于复合主键的字段实现即可。

方案2：接口+默认方法（Java 8+） #

不想用继承的话，可以定义接口通过默认方法实现通用逻辑，要求所有实体提供ID的获取方法：

import java.io.Serializable;

public interface EntityWithId<T extends Serializable> {
    T getId();

    default boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        EntityWithId<?> that = (EntityWithId<?>) o;
        return getId() != null && getId().equals(that.getId());
    }

    default int hashCode() {
        return getId() != null ? getId().hashCode() : super.hashCode();
    }
}

实体类实现该接口：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class MyEntity implements EntityWithId<Long> {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    @Override
    public Long getId() {
        return id;
    }

    // 业务字段的getter、setter
}

方案3：Lombok简化实现 #

如果项目允许引入Lombok，这是最简洁的方式：

1. 定义基类，用Lombok注解指定基于ID生成equals和hashCode：

import jakarta.persistence.*;
import lombok.EqualsAndHashCode;

@MappedSuperclass
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
public abstract class BaseEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @EqualsAndHashCode.Include
    private Long id;

    // ID的getter、setter
}

2. 实体类继承基类，无需额外配置：

import jakarta.persistence.Entity;
import lombok.Getter;
import lombok.Setter;

@Entity
@Getter
@Setter
public class MyEntity extends BaseEntity {
    private String name;
}

Lombok会自动帮你生成符合要求的equals和hashCode方法，无需手动编写。

避坑提醒 #

• 不要用业务字段实现equals和hashCode，否则业务字段变更会导致集合中实体定位异常
• 必须处理ID为null的场景（未持久化的实体），否则同一会话中新建的多个实体会被误判为相等
• 如果用Hibernate等JPA实现，判断类时可以用Hibernate.getClass(o)代替o.getClass()，避免代理类导致的类型判断失败

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