本文详解 Hibernate 中自引用 @ManyToMany 实体的正确建模方式、JPQL/QueryDSL 查询技巧，以及避免 SQL 语法错误和 N+1 问题的关键实践。
本文详解 hibernate 中自引用 `@manytomany` 实体的正确建模方式、jpql/querydsl 查询技巧，以及避免 sql 语法错误和 n+1 问题的关键实践。
在构建药品分类等具有树形结构的业务模型时，MedicamentGroup 常需表达“组包含子组”的自引用关系（即一个分组可拥有多个子分组，同时自身也可隶属于其他分组）。此时若直接在 QueryDSL 中使用 .select(..., childrens) 投影关联集合，会触发 Hibernate 的底层 SQL 生成异常——正如错误日志所示：ERROR: syntax error at or near "."。其根本原因在于：QueryDSL 的 select() 不支持直接投影 @ManyToMany 集合属性；Hibernate 无法将集合字段映射为 SQL 列，导致生成非法语句（如 SELECT ..., . as col_2_0_）。
✅ 正确建模：精简注解 + 显式关联表配置
首先，修正实体类中的双向自引用映射。原代码中两个 @ManyToMany 均使用了 @JoinTable，但未指定 mappedBy，导致 Hibernate 误判为两个独立的单向关系，从而生成冗余 JOIN 并破坏 SQL 结构。应改为：
@Entity
@Table(name = "medicaments_group")
@Getter @Setter
public class MedicamentGroup extends GenericDictionary {
@Id
private Long id;
private boolean groupMain;
// 主动方：此分组的直接子分组（childrens）
@ManyToMany(fetch = FetchType.LAZY)
@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<>();
// 被动方：此分组的父分组（childrenOf），由 childrens 维护，无需重复建表
@ManyToMany(mappedBy = "childrens", fetch = FetchType.LAZY)
private List<MedicamentGroup> childrenOf = new ArrayList<>();
}⚠️ 关键说明：
- childrens 是关系的拥有方（owning side），负责维护 medicaments_group_join 表；
- childrenOf 是反向映射（inverse side），通过 mappedBy = "childrens" 告知 Hibernate 复用同一张关联表；
- 移除 cascade = CascadeType.ALL（除非业务强需求级联操作），避免意外删除父组时级联清除整个子树；
- 显式声明 fetch = FetchType.LAZY 防止无意识的 EAGER 加载引发 N+1 查询。
✅ 正确查询：避免投影集合，改用 JPQL 或 EntityGraph
QueryDSL 的 select(..., childrens) 是非法用法。推荐两种健壮方案：
方案一：JPQL + JOIN FETCH（推荐用于简单场景）
@Repository
public interface MedicamentGroupRepository extends JpaRepository<MedicamentGroup, Long> {
@Query("SELECT DISTINCT mg FROM MedicamentGroup mg " +
"LEFT JOIN FETCH mg.childrens child " +
"WHERE mg.groupMain = false")
List<MedicamentGroup> findGroupsAndChildren();
}- DISTINCT 消除因 JOIN FETCH 导致的重复根实体；
- LEFT JOIN FETCH 在单次 SQL 中预加载子集合，彻底规避 N+1；
- 返回的是已初始化 childrens 的完整实体，无需手动组装。
方案二：EntityGraph（更灵活，适合复杂条件）
// 定义图
@NamedEntityGraph(
name = "MedicamentGroup.withChildren",
attributeNodes = @NamedAttributeNode("childrens")
)
@Entity
@Table(name = "medicaments_group")
public class MedicamentGroup { ... }
// 使用
@EntityGraph(value = "MedicamentGroup.withChildren", type = EntityGraph.EntityGraphType.LOAD)
List<MedicamentGroup> groups = repository.findAll(
Example.of(new MedicamentGroup().setGroupMain(false))
);❌ 错误实践与注意事项
- 不要在 QueryDSL/JPA Criteria 中 select 集合属性：select(..., root.get("childrens")) 必然失败；
- 勿盲目删库重建：答案中“删除数据库再创建”仅是掩盖问题（如旧表结构残留），非根本解法；
- 警惕循环引用序列化：若返回 JSON，需在 childrens 和 childrenOf 上添加 @JsonIgnore 或 @JsonManagedReference/@JsonBackReference；
-
启用 SQL 日志验证：在 application.yml 中添加
spring: jpa: show-sql: true properties: hibernate: format_sql: true确保生成的 SQL 包含预期的 JOIN medicaments_group_join 和 JOIN medicaments_group。
通过以上调整，即可安全、高效地获取带子节点的药品分组列表，同时保持代码清晰性与数据库一致性。
