Spring JPA中如何将两个实体类映射到同一张数据库表适配不同查询

完全不需要强制创建多个实体类，JPA原生支持同一张表返回不同字段的需求，以下是两种可落地的实现方案： #

方案一：投影（Projection）方案【优先推荐】 #

仅需维护一个映射全表字段的实体类，针对不同返回字段定义对应的投影接口即可，轻量无额外映射负担。

1. 定义基础CarEntity映射CAR表全字段：

@Entity
@Table(name = "CAR")
public class CarEntity {
    @Id
    private Long id;
    private String carType;
    private String carModel;
    private Integer carYear;
    private Integer accidentYear;
    private LocalDate buyDay;
    // 省略getter、setter、无参构造方法
}

2. 针对两个查询分别定义投影接口，接口方法名和实体类字段的getter保持一致即可：

• 第一个查询投影（返回5个字段）：

public interface CarWithoutAccidentProjection {
    String getCarType();
    String getCarModel();
    Integer getCarYear();
    Integer getAccidentYear();
    LocalDate getBuyDay();
}

• 第二个查询投影（返回2个字段）：

public interface CarNewModelProjection {
    String getCarModel();
    Integer getCarYear();
}

3. 在Repository中定义对应查询方法，直接返回投影类型：

public interface CarRepository extends JpaRepository<CarEntity, Long> {
    // 适配第一个查询：事故年份为空的车辆
    List<CarWithoutAccidentProjection> findAllByAccidentYearIsNull();
    
    // 适配第二个查询：年份大于等于当前年份的车辆
    @Query("SELECT c.carModel AS carModel, c.carYear AS carYear FROM CarEntity c WHERE c.carYear >= :currentYear")
    List<CarNewModelProjection> findAllNewCars(Integer currentYear);
}

返回的投影实例可以直接序列化作为API接口的返回值，完全符合业务需求。 #

方案二：多实体类映射同一张表 #

如果确实需要多个实体类映射同一张CAR表（比如需要对不同视图做持久化操作），只需要保证两个实体类都显式指定相同的@Table表名，同时都声明主键字段即可：

// 适配第一个查询的实体类，加@Immutable避免误修改
@Entity
@Table(name = "CAR")
@Immutable
public class CarWithoutAccidentEntity {
    @Id
    private Long id;
    private String carType;
    private String carModel;
    private Integer carYear;
    private Integer accidentYear;
    private LocalDate buyDay;
    // 省略getter、setter
}

// 适配第二个查询的实体类
@Entity
@Table(name = "CAR")
@Immutable
public class CarNewModelEntity {
    @Id
    private Long id;
    private String carModel;
    private Integer carYear;
    // 省略getter、setter
}

如果只是查询场景不涉及数据写入，不推荐该方案，会增加实体维护成本。

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