JPA、Hibernate中基于复合主键部分字段关联两张表的问题

问题原因 #

Hibernate（及JPA规范）默认要求实体间的关联外键必须匹配目标实体的完整主键字段集合。你的场景中，主表SFTSEB2的复合主键包含5个字段，但SFTSEB3仅通过其中4个字段关联，不符合Hibernate的关联校验规则，因此抛出字段数不匹配的错误。双向映射无法解决这个问题——它仅维护关联的双向关系，核心的主键字段数不匹配问题依然存在。

可行解决方案 #

方案1：使用@JoinColumnsOrFormulas手动指定关联条件 #

在Sftseb3实体类中，放弃默认的主键关联逻辑，通过@JoinColumnsOrFormulas显式定义仅包含4个字段的关联规则，同时保留Sftseb2实体的完整5字段主键以保证数据唯一性。

示例代码：

// Sftseb3实体中的关联字段定义
@ManyToOne
@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(column = @JoinColumn(name = "EMPFKEY", referencedColumnName = "EMPFKEY")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "EBMSG", referencedColumnName = "EBMSG")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "EBBORD", referencedColumnName = "EBBORD")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "EBSORT", referencedColumnName = "EBSORT"))
})
private Sftseb2 sftseb2;

注意：这种方式下，Hibernate不会自动维护该关联的级联操作（如cascade = CascadeType.ALL可能失效），需要手动处理数据同步逻辑。

方案2：基于数据库视图创建中间实体 #

在数据库中创建包含SFTSEB2所有字段的视图（如V_SFTSEB2），并为视图的4个关联字段添加复合唯一约束。然后基于该视图创建JPA实体，让Sftseb3关联这个视图实体时使用4个字段的约束。

步骤：

1. 创建视图：

CREATE VIEW V_SFTSEB2 AS 
SELECT EMPFKEY, EBMSG, EBBORD, EBSORT, EBREFN, /* 其他业务字段 */
FROM SFTSEB2;

2. 为视图添加复合唯一约束（部分数据库支持，如Oracle、PostgreSQL）：

ALTER VIEW V_SFTSEB2 ADD CONSTRAINT UK_V_SFTSEB2_4COL UNIQUE (EMPFKEY, EBMSG, EBBORD, EBSORT);

3. 创建视图对应的JPA实体，保留5个字段的主键以保证原表数据唯一性，同时将4个关联字段标记为唯一键。
4. Sftseb3关联该视图实体，使用4个字段进行关联。

方案3：使用原生SQL查询绕过映射校验 #

如果关联操作不频繁，可以直接使用原生SQL编写关联查询，绕过JPA的映射规则限制，将查询结果映射到DTO或实体对象。

示例代码：

String sql = "SELECT b3.*, b2.* FROM SFTSEB3 b3 JOIN SFTSEB2 b2 " +
             "ON b3.EMPFKEY = b2.EMPFKEY " +
             "AND b3.EBMSG = b2.EBMSG " +
             "AND b3.EBBORD = b2.EBBORD " +
             "AND b3.EBSORT = b2.EBSORT";
Query query = entityManager.createNativeQuery(sql, YourResultDTO.class);
List<YourResultDTO> results = query.getResultList();

这种方式适合简单的关联查询场景，避免复杂的映射配置。

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