本文详解 Hibernate 中自引用（self-referencing）多对多实体的正确建模方式，指出原代码中 @JoinTable 配置冲突导致 SQL 语法错误的根本原因，并提供可运行的实体定义、JPQL 查询示例及关键注意事项。
本文详解 hibernate 中自引用（self-referencing）多对多实体的正确建模方式，指出原代码中 `@jointable` 配置冲突导致 sql 语法错误的根本原因，并提供可运行的实体定义、jpql 查询示例及关键注意事项。
在 Hibernate 中实现自引用多对多关系（如药品分组中的父子分组）时，最常见且隐蔽的错误是为同一张关联表（medicaments_group_join）重复声明两个方向相反的 @ManyToMany + @JoinTable 映射——这会导致 Hibernate 无法生成合法 SQL，正如报错中出现的 ERROR: syntax error at or near "."（位置 74），其根源正是 QueryDSL 尝试投影未被正确解析的集合属性 childrens，而该属性因元数据冲突未被 Hibernate 正确识别为可查询路径。
✅ 正确的实体映射方式
必须仅在一个方向上声明 @JoinTable，另一方向使用 mappedBy 指向它，以明确双向关系的拥有方（owning side）。否则 Hibernate 会尝试为两个 @ManyToMany 各自生成 JOIN 逻辑，引发元数据歧义和 SQL 构造失败：
@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;
// 拥有方：负责维护关联表，定义 @JoinTable
@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
@JoinTable(
name = "medicaments_group_join",
joinColumns = @JoinColumn(name = "medicament_group_id"), // 当前分组 ID
inverseJoinColumns = @JoinColumn(name = "medicament_join_id") // 子分组 ID
)
private List<MedicamentGroup> childrens = new ArrayList<>();
// 被拥有方：通过 mappedBy 关联到 childrens，不定义 @JoinTable
@ManyToMany(mappedBy = "childrens")
private List<MedicamentGroup> childrenOf = new ArrayList<>();
}⚠️ 关键说明：
- childrens 是关系拥有方，Hibernate 仅据此生成 INSERT/UPDATE 关联记录；
- childrenOf 是反向导航属性，仅用于读取，其值由 childrens 的变更自动同步（需确保双向一致性，建议在 setter 中维护）；
- 移除 @JoinTable 的重复声明后，QueryDSL 或 JPQL 才能正确识别 childrens 为合法关联路径。
✅ 安全获取分组及其子分组的推荐方式
避免在 QueryDSL 中直接 select(..., childrens) —— 这易触发 N+1 或投影异常。推荐使用 JOIN FETCH 的 JPQL 查询，确保一次性加载主实体及其懒加载集合：
@Repository
public class MedicamentGroupRepositoryImpl implements MedicamentGroupRepository {
@PersistenceContext
private EntityManager entityManager;
@Override
public List<MedicamentGroup> getGroupsAndItsChildren() {
String jpql = """
SELECT DISTINCT mg FROM MedicamentGroup mg
LEFT JOIN FETCH mg.childrens child
WHERE mg.groupMain = false
ORDER BY mg.id
""";
return entityManager.createQuery(jpql, MedicamentGroup.class)
.getResultList();
}
}- LEFT JOIN FETCH 确保 childrens 在单次查询中被初始化，避免 LazyInitializationException；
- DISTINCT 消除因 JOIN 导致的重复根实体（Hibernate 自动处理）；
- 不依赖 QueryDSL 的 Tuple 手动映射，规避字段投影错误风险。
? 注意事项与最佳实践
- 数据库重建非根本解法：答案中“删库重创”可能暂时绕过缓存或元数据残留，但未解决映射逻辑缺陷，生产环境严禁使用；
- 级联策略谨慎选择：CascadeType.ALL 可能意外删除父分组时连带清除子分组关联，建议仅用 PERSIST/MERGE；
-
双向关系一致性：在业务代码中添加辅助方法，例如：
public void addChild(MedicamentGroup child) { this.childrens.add(child); child.childrenOf.add(this); // 维护反向引用 } - 性能监控：对深层嵌套的自引用树（如无限递归分组），应结合 @OrderBy 或数据库 CTE 查询优化，避免内存溢出。
通过以上修正，即可稳定获取 List<MedicamentGroup>，每个对象的 childrens 字段均已被预加载，满足前端树形结构渲染等典型需求。
