如何在 Hibernate 中正确映射并查询自引用多对多实体关系

本文详解 Hibernate 中自引用（self-referencing）@ManyToMany 关系的正确建模与数据获取方式，重点解决因错误使用 @JoinTable 导致的 SQL 语法异常、字段投影失败及 N+1 查询问题。

先说一个核心判断：在 Hibernate 中处理自引用 @ManyToMany 关系，如果建模不当，很容易踩进一个坑——在 JPQL 或 QueryDSL 里跑出来的 SQL 看起来像是“长了刺”，各种语法错误，比如 SELECT 子句里冒出个孤零零的逗号，PostgreSQL 直接报错 “syntax error at or near "."”。问题根源，往往是给同一个关联关系定义了两个方向相反的 @ManyToMany，并且各自都配了一套完整的 @JoinTable。

实际场景中，比如构建药品分组体系，我们经常用同一张表（比如 medicaments_group）通过一张关联表（比如 medicaments_group_join）来表达“父分组”和“子分组”的关系。这时候，如果实体里同时定义了 childrens 和 childrenOf 两个集合，并且都显式声明了 @JoinTable，Hibernate 就懵了——它无法为这个双向自引用集合生成正确的别名和投影路径，于是 SQL 就乱了。

正确建模：单向映射 + mappedBy 维护反向关系

关键在于，你得把其中一个集合设为“拥有方”（owning side），另一个设为“被维护方”（inverse side），通过 mappedBy 建立逻辑关联，避免重复定义 @JoinTable。来看代码：

@Entity
@Table(name = "medicaments_group")
@Getter
@Setter
public class MedicamentGroup extends GenericDictionary {

    @Id
    private Long id;

    @Column(name = "group_main")
    private boolean groupMain;

    @Column(name = "short_name")
    private String shortName;

    // 拥有方：定义关联表和外键列
    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    @JoinTable(
        name = "medicaments_group_join",
        joinColumns = @JoinColumn(name = "medicament_group_id"),      // 当前分组ID → 父ID
        inverseJoinColumns = @JoinColumn(name = "medicament_join_id") // 关联分组ID → 子ID
    )
    private List children = new ArrayList<>();

    // 被维护方：通过 mappedBy 关联到拥有方，不定义 @JoinTable
    @ManyToMany(mappedBy = "children", cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    private List parents = new ArrayList<>(); // 更语义化的命名：parents 而非 childrenOf
}

⚠️ 注意事项：

• mappedBy = "children" 中的 "children" 必须严格匹配拥有方字段名（非数据库列名）；
• 移除原 childrenOf 字段上冗余的 @JoinTable，否则 Hibernate 会尝试为同一张关联表生成两套映射，引发元数据冲突；
• 推荐使用 parents 替代 childrenOf，语义更清晰，且避免歧义。

安全查询：避免 QueryDSL 投影集合

很多人在 QueryDSL 里习惯这么做：直接在 select() 里写上 .select(id, shortName, childrens)，但 Hibernate 并不支持在 SELECT 子句中直接选取集合属性——这会导致生成无效 SQL，比如 ., medicament2_.id... 这样的东西。正确的做法是分两步走，或者用 JOIN FETCH 显式关联子集。

推荐使用 Entity Graph，类型安全且可复用：

@Repository
public class MedicamentGroupRepositoryImpl implements MedicamentGroupRepository {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List getGroupsAndItsChildren() {
        // 定义实体图：确保 children 集合被 JOIN FETCH 加载
        EntityGraph graph = entityManager.createEntityGraph(MedicamentGroup.class);
        graph.addAttributeNodes("children");
        return entityManager.createQuery(
                "SELECT mg FROM MedicamentGroup mg WHERE mg.groupMain = false", 
                 MedicamentGroup.class)
            .setHint("org.hibernate.fetchGraph", graph)
            .getResultList();
    }
}

或者直接用 JPQL 显式 JOIN FETCH，更直观：

@Override
public List getGroupsAndItsChildren() {
    return entityManager.createQuery(
            "SELECT DISTINCT mg FROM MedicamentGroup mg " +
            "LEFT JOIN FETCH mg.children ch " +
            "WHERE mg.groupMain = false", 
             MedicamentGroup.class)
        .getResultList();
}

✅ 关键点：

• LEFT JOIN FETCH 确保 children 在单次查询中被初始化，避免懒加载 N+1 问题；
• DISTINCT 消除因 JOIN 导致的重复根实体（Hibernate 自动处理，但显式声明更稳妥）；
• 绝不在 SELECT 子句中写 mg.children —— 只能用于 FETCH。

补充说明：为何“删库重建”有时有效？

有时候你会看到有人建议“删除数据库后重建”，这其实是在清除 Hibernate 自动生成的过时 DDL 元数据缓存。当实体映射从错误的双 @JoinTable 改为正确的 mappedBy 后，旧数据库可能残留不兼容的外键约束或视图定义，导致 Hibernate 初始化失败。但这种方法只是临时规避，根本解法始终是修正映射逻辑。

最终验证要点

• ✅ 启动应用时检查 Hibernate 日志，确认生成的 CREATE TABLE medicaments_group_join 仅有一份，且含两个外键指向 medicaments_group.id；
• ✅ 执行查询后，调用 group.getChildren().size() 不触发额外 SQL（证明 FETCH 生效）；
• ✅ 数据库中 medicaments_group_join 表结构符合预期：medicament_group_id（父）与 medicament_join_id（子）均为 BIGINT 外键。

通过以上三步——修正映射、禁用集合投影、启用 JOIN FETCH——你就能稳定获取带子节点的药品分组列表，彻底规避语法错误与性能陷阱。