Spring Boot中JPA多继承实现多视图分页查询的问题

现有如下JPA实体模型（基于Spring Boot 3.1.2）：

@Entity
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
public class Operation {
    @Id
    private int id;
  
}

@Entity
public class Payment extends Operation {

}
@Entity
public class Transfer extends Operation /*, Operation1*/ {

}

@Entity
public class Payout extends Operation1 {
}

@Repository
public interface OperationRepo extends JpaRepository<Operation, Integer>{
    Page<Operation> findAll(Pageable pageable); // 可获取Payment和Transfer的分页数据，用于某类余额报表（Payment记正、Transfer记负）
}

public interface OperationRepo1 extends JpaRepository<Operation1, Integer>{
    Page<Operation1> findAll(Pageable pageable); // 需要获取Transfer和Payout的分页数据用于收款方余额页面（Transfer记正、Payout记负），当前模型无法实现
}

当前模型在第一种余额报表场景下运行正常，但需新增收款方余额页面场景：要把Transfer视为正、Payout视为负并实现联合分页。不能直接让Payout继承Operation（会打乱原有三个类的通用仓库逻辑），需要找到无需多继承的优雅解决方案。

更新尝试：曾尝试为Transfer表定义只读的第二个实体，代码如下，但抛出org.hibernate.DuplicateMappingException异常：

@Entity
@Table(name = "transfer")
public class TransferSecond extends Operation1 

可行解决方案 #

方案1：用@MappedSuperclass重构公共字段 #

把Operation和Operation1的公共字段抽离到一个父类，通过@MappedSuperclass实现字段复用，再分别扩展出两个业务场景的实体父类：

1. 定义公共映射父类（包含所有业务场景需要的公共字段）：

@MappedSuperclass
public abstract class BaseOperation {
    @Id
    private int id;
    // 补充日期、金额等所有公共字段
}

2. 重构原有实体结构：

// 原有余额报表场景的父实体
@Entity
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
public class Operation extends BaseOperation {
    // 仅保留该场景专属字段（无则留空）
}

@Entity
public class Payment extends Operation {
}

@Entity
public class Transfer extends Operation {
}

// 新增收款方场景的父实体
@Entity
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
public class Operation1 extends BaseOperation {
    // 仅保留该场景专属字段（无则留空）
}

@Entity
public class Payout extends Operation1 {
}

3. 为Transfer新增只读实体，关联原表并继承Operation1：

@Entity
@Table(name = "transfer")
@Immutable // 标记为只读，避免修改冲突
@AttributeOverrides({
    @AttributeOverride(name = "id", column = @Column(name = "id"))
    // 其他字段若有映射冲突，可在这里显式覆盖
})
public class TransferForPayee extends Operation1 {
    // 无需新增字段，直接继承公共字段
}

4. 为收款方场景创建自定义仓库，通过JPQL实现联合分页：

@Repository
public interface PayeeOperationRepo extends JpaRepository<Operation1, Integer> {
    @Query("SELECT o FROM Operation1 o UNION SELECT tfp FROM TransferForPayee tfp")
    Page<BaseOperation> findAllForPayee(Pageable pageable);
}

返回BaseOperation类型即可获取所有公共字段，业务层再根据类型区分处理正负逻辑。

方案2：DTO投影+原生SQL联合查询 #

不修改现有实体结构，直接从数据库层面查询联合数据并映射到DTO，适合只读场景：

1. 定义收款方场景的DTO：

public class PayeeOperationDTO {
    private int id;
    private LocalDateTime date;
    private BigDecimal amount;
    private String type; // 标记是TRANSFER还是PAYOUT，用于区分正负

    // 全参构造函数、getter/setter
}

2. 在仓库中定义原生SQL查询：

@Repository
public interface PayeeOperationRepo {
    @Query(value = "SELECT id, date, amount, 'TRANSFER' as type FROM transfer " +
                   "UNION ALL " +
                   "SELECT id, date, amount, 'PAYOUT' as type FROM payout",
           countQuery = "SELECT COUNT(*) FROM (SELECT id FROM transfer UNION ALL SELECT id FROM payout) t",
           nativeQuery = true)
    Page<PayeeOperationDTO> findAllForPayee(Pageable pageable);
}

这种方式完全绕开实体继承限制，直接获取需要的数据，实现成本最低。

方案3：修复重复映射异常（针对你的更新尝试） #

如果坚持要为Transfer表创建第二个实体，可通过配置允许同表多实体映射，同时标记只读避免冲突：

1. 调整第二个实体的定义：

@Entity(name = "TransferSecond") // 指定唯一的实体名称
@Table(name = "transfer")
@Immutable // 标记为只读，禁止修改操作
public class TransferSecond extends Operation1 {
    @Id
    @Column(name = "id")
    private int id;
    // 其他字段若需显式映射，可在这里补充
}

2. 在Spring Boot配置文件中添加允许同表多映射的配置：

spring.jpa.properties.hibernate.mapping.allow_duplicate_table_names=true

⚠️注意：这种方式可能引发缓存不一致问题（两个实体对应同一张表，修改其中一个会导致另一个缓存失效），仅适合纯只读场景。

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