JPA单向@OneToMany关联动态表名同表的原生查询映射问题

一、先解决Table 'RankingAward$AdditionalPlacements' doesn't exist异常 #

静态内部实体AdditionalPlacements会被JPA当作独立实体处理，默认使用RankingAward$AdditionalPlacements作为表名，导致找不到对应表。需要显式指定它与主实体共享同一张动态表：

@Entity
@Table(name = "${dynamic.table.name}") // 这里的动态表名表达式和你的实际实现一致
public class RankingAward {
    @Id
    private Long id;
    private String awardName;
    // 其他主实体字段...

    // 单向@OneToMany关联，指定目标实体为内部类
    @OneToMany(targetEntity = AdditionalPlacements.class)
    @JoinColumn(name = "main_award_id", referencedColumnName = "id") // 自连接外键字段，根据你的表结构调整
    private Set<AdditionalPlacements> otherPlacements;

    // 静态内部实体，显式指定表名与主实体一致
    @Entity
    @Table(name = "${dynamic.table.name}")
    public static class AdditionalPlacements {
        @Id
        private Long id;
        private Long mainAwardId; // 对应主实体id的外键字段
        private String placementName;
        // 其他关联字段...
    }
}

二、自定义SQL查询并映射关联集合 #

NativeQuery不会自动将自连接结果映射到实体集合，需要手动处理结果集，或通过@SqlResultSetMapping定义映射规则后组装数据。

方法1：使用@SqlResultSetMapping + 手动组装

1. 在主实体上定义结果映射规则：

@Entity
@Table(name = "${dynamic.table.name}")
@SqlResultSetMapping(
    name = "RankingAwardWithPlacements",
    entities = {
        @EntityResult(
            entityClass = RankingAward.class,
            fields = {
                @FieldResult(name = "id", column = "a1_id"),
                @FieldResult(name = "awardName", column = "a1_award_name")
                // 主实体其他字段依次对应a1别名的列
            }
        ),
        @EntityResult(
            entityClass = RankingAward.AdditionalPlacements.class,
            fields = {
                @FieldResult(name = "id", column = "a2_id"),
                @FieldResult(name = "mainAwardId", column = "a2_main_award_id"),
                @FieldResult(name = "placementName", column = "a2_placement_name")
                // 内部实体其他字段依次对应a2别名的列
            }
        )
    }
)
public class RankingAward {
    // ... 实体内容
}

2. 编写带别名的自连接SQL：

SELECT 
    a1.id AS a1_id, a1.award_name AS a1_award_name,
    a2.id AS a2_id, a2.main_award_id AS a2_main_award_id, a2.placement_name AS a2_placement_name
FROM ${dynamic.table.name} a1
LEFT JOIN ${dynamic.table.name} a2 ON a1.id = a2.main_award_id
WHERE a1.id = ?

3. 执行查询并组装结果：

List<Object[]> resultRows = entityManager.createNativeQuery(sql, "RankingAwardWithPlacements")
    .setParameter(1, targetAwardId)
    .getResultList();

// 用Map分组，避免重复创建主实体
Map<Long, RankingAward> awardMap = new HashMap<>();
for (Object[] row : resultRows) {
    RankingAward mainAward = (RankingAward) row[0];
    RankingAward.AdditionalPlacements placement = (RankingAward.AdditionalPlacements) row[1];

    if (!awardMap.containsKey(mainAward.getId())) {
        mainAward.setOtherPlacements(new HashSet<>());
        awardMap.put(mainAward.getId(), mainAward);
    }
    if (placement != null) {
        awardMap.get(mainAward.getId()).getOtherPlacements().add(placement);
    }
}

// 获取最终组装好的主实体
RankingAward finalAward = awardMap.values().stream().findFirst().orElse(null);

方法2：直接用JPQL查询（若动态表名映射支持JPQL）

如果动态表名能被JPA正确识别，可直接用JPQL查询，再手动组装集合：

SELECT a, ap
FROM RankingAward a
LEFT JOIN AdditionalPlacements ap ON a.id = ap.mainAwardId
WHERE a.id = :awardId

执行查询后的组装逻辑和方法1一致，遍历返回的Object[]数组，将ap实例添加到a的otherPlacements集合中。

三、关键注意事项 #

• 确保主实体和内部实体的@Id字段正确，JPA依赖主键识别实体唯一性。
• 动态表名的表达式需与你的实际实现一致（比如Spring的占位符、Hibernate的命名策略），保证主实体和内部实体指向同一张表。
• 自连接的外键字段需与@JoinColumn注解中的配置匹配，避免关联关系失效。

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