在构建药品分类这类具有树形结构的业务模型时，我们常常会遇到一个典型的场景：一个分组（例如MedicamentGroup）既可能包含多个子分组，同时自身也可能隶属于其他父分组。这种自引用的多对多关系，如果建模或查询不当，很容易踩坑。最常见的错误之一，就是在使用QueryDSL进行查询时，试图直接投影（select）一个@ManyToMany集合属性，结果触发令人困惑的SQL语法错误：ERROR: syntax error at or near "."。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

这背后的根本原因其实很明确：QueryDSL的select()方法并不支持直接投影关联集合属性。Hibernate在尝试将集合字段映射为SQL列时，会生成非法的语句（例如SELECT ..., . as col_2_0_），从而导致数据库报错。

✅ 正确建模：精简注解与显式关联表配置

要解决这个问题，首先得从实体映射的源头入手。一个常见的误区是在双向自引用关系中都使用了@JoinTable，却没有指定mappedBy属性。这会让Hibernate误以为这是两个独立的单向关联，进而生成冗余的关联表并破坏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 childrens = new ArrayList<>();

    // 被动方：此分组的父分组（childrenOf），由 childrens 维护，无需重复建表
    @ManyToMany(mappedBy = "childrens", fetch = FetchType.LAZY)
    private List 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

既然知道了select(..., childrens)是非法操作，那么该如何安全高效地查询并加载关联的子集合呢？这里推荐两种经过验证的健壮方案。

方案一：JPQL + JOIN FETCH（推荐用于简单场景）

对于查询条件相对固定的场景，直接在Repository中使用JPQL的JOIN FETCH是最清晰直接的方式。

@Repository
public interface MedicamentGroupRepository extends JpaRepository {
    @Query("SELECT DISTINCT mg FROM MedicamentGroup mg " +
           "LEFT JOIN FETCH mg.childrens child " +
           "WHERE mg.groupMain = false")
    List findGroupsAndChildren();
}

这里有几个要点：

• 使用DISTINCT是为了消除因JOIN FETCH可能导致返回的根实体重复的问题。
• LEFT JOIN FETCH是关键，它能在同一次SQL查询中预先加载childrens集合，从而彻底规避后续遍历时触发的N+1查询。
• 查询返回的已经是childrens集合被初始化好的完整实体，无需再进行手动组装。

方案二：EntityGraph（更灵活，适合复杂条件）

当查询条件动态多变，或者你希望将加载策略与查询逻辑解耦时，EntityGraph是更优雅的选择。

// 1. 在实体类上定义图
@NamedEntityGraph(
    name = "MedicamentGroup.withChildren",
    attributeNodes = @NamedAttributeNode("childrens")
)
@Entity
@Table(name = "medicaments_group")
public class MedicamentGroup { ... }

// 2. 在查询时应用图
@EntityGraph(value = "MedicamentGroup.withChildren", type = EntityGraph.EntityGraphType.LOAD)
List groups = repository.findAll(
    Example.of(new MedicamentGroup().setGroupMain(false))
);

这种方式将“加载什么关联”的定义（EntityGraph）与“如何查询”（Example查询、QueryDSL等）分离开，代码结构更清晰，也更容易复用。

❌ 错误实践与注意事项

最后，再梳理几个需要警惕的常见陷阱：

• 绝对不要在QueryDSL或JPA Criteria API中直接select集合属性：像select(..., root.get("childrens"))这样的操作注定会失败，这是框架层面的限制。
• 勿用“删库重建”作为解决方案：有些临时性的“解决方案”会建议删除数据库再重新创建。这本质上只是掩盖了问题（比如残留的错误表结构），并非根本解决之道，在正式环境中更是危险操作。
• 警惕循环引用导致的序列化问题：如果你的实体需要通过JSON接口返回，childrens和childrenOf之间的双向引用会导致无限递归序列化。记得在其中一个集合上使用@JsonIgnore，或者使用@JsonManagedReference/@JsonBackReference注解对来妥善处理。
• 启用SQL日志进行验证：在开发阶段，强烈建议开启SQL日志来验证Hibernate生成的语句是否符合预期。在application.yml中添加如下配置：

spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true

这样，你就能清晰地看到生成的SQL是否正确地关联了medicaments_group_join和medicaments_group表。

遵循以上这些实践，你就能安全、高效地处理Hibernate中的自引用@ManyToMany实体，在获取带子节点的完整树形结构数据的同时，确保代码的清晰性和数据库操作的一致性。

相关攻略

电脑教程

戴尔笔记本电脑连接手机热点的两种方法

戴尔笔记本连接手机热点：一篇讲透的实战指南 想把手机流量变成戴尔笔记本的无线网络？这事儿其实比想象中更简单。核心流程不外乎两步：先在手机上打开热点并做好设置，然后在笔记本的Wi-Fi列表里找到它、输入密码。整个过程，依赖的是笔记本内置的无线网卡和通用的Wi-Fi协议，完全无需额外配件。无论是安卓还是

热心网友

05.08

电脑教程

三星显示器连接笔记本步骤详解

三星显示器连接笔记本电脑，最主流且稳定的方式 想让三星显示器为你的笔记本“添屏加彩”？最主流、也最稳定的方式，还是通过HDMI或USB-C线缆直连，再辅以系统快捷键（比如常见的Fn+F4）快速切换显示模式。好消息是，如今主流的三星显示器普遍配备了HDMI 2 0甚至全功能的USB-C接口，不仅支持最

热心网友

05.08

电脑教程

史密斯热水器如何自行清洁水垢详细操作指南

史密斯热水器清理污垢：一份用户友好的深度清洁指南 给家里的史密斯热水器做一次深度清洁、清一清内胆水垢，这事儿听起来挺专业，但真上手了你会发现，普通用户完全能自己搞定。当然，前提是得把安全规范刻在脑子里。根据品牌官方的售后指南，再结合不少资深维修技师的实操反馈，整套流程其实相当清晰：从断电断水开始，到

热心网友

05.08

电脑教程

红米Note全面屏手机如何设置返回键方法

红米Note的返回键，到底去哪儿了？ 关于红米Note系列全面屏机型的返回键，一个常见的误解是它被“砍掉”了。其实并非如此。这不是硬件上的物理缺失，而是一个由系统导航方式决定的显示选项——只要在设置里切换到“经典导航键”模式，你熟悉的那个虚拟三键布局，立马就能回来。这个设计的初衷，是源于MIUI H

热心网友

05.08

电脑教程

vivo手机拍月亮模糊的解决办法与原因分析

告别模糊，拍出清晰的月亮：一份vivo手机拍月实操指南 用vivo手机拍月亮，结果总是一片模糊或白茫茫？这问题挺常见，但根子不在手机硬件不行，而在于我们用的“姿势”没对上月球的“脾气”。月亮距离远、亮度高、背景暗，普通拍照模式那套自动逻辑，在这种极端场景下就容易“懵圈”——对焦找不到目标，曝光控不住

热心网友

05.08

热门推荐

电脑教程

小米手机联系人备份到云盘详细步骤指南

小米云盘备份联系人，不止是“开启同步”那么简单 提到备份手机通讯录，很多人的第一反应就是打开云同步开关。没错，小米云盘备份联系人的核心路径，确实是基于小米云服务的“同步联系人”功能。但想让整个过程真正做到无缝、可靠，里头还有些细节值得琢磨。 简单来说，当你在一部已登录小米账号的手机上，进入「设置」→

热心网友

05.09

电脑教程

小米云服务登录能否使用微信快捷登录

小米云盘支持微信快捷登录吗？深度解析操作与细节 答案是肯定的。目前，小米云盘确实接入了微信快捷登录。用户在App或网页端的登录界面，找到“第三方账号登录”选项，点击微信图标，经过简单的授权确认，就能完成身份验证。整个过程无需反复输入手机号和密码，对于经常在多设备间切换的用户来说，便捷性的提升是实实在

热心网友

05.09

电脑教程

Cinema 4D树叶模型贴图添加详细步骤教程

给树叶“穿上”逼真外衣：C4D模型贴图全流程解析 MAXON Cinema 4D 在三维建模领域的受欢迎程度不言而喻，尤其在进行有机形态创作时，其灵活性备受青睐。不过，很多朋友在为一个变形后的树叶模型添加贴图时，常会碰到贴图错位、拉伸的尴尬情况。这到底是怎么回事，又该如何解决？下面，我们就通过一个完

热心网友

05.09

电脑教程

iOS15微信来电铃声设置教程与自定义方法

iOS 15微信通话铃声设置全攻略：告别默认提示音 在iOS 15上想让微信语音视频通话的铃声与众不同？其实方法比想象中直接——这事儿不靠系统电话设置，也无需借助第三方快捷指令。一切操作，都在微信的“新消息通知”设置里完成。具体路径很清晰：打开微信，进入「我 → 设置 → 新消息通知」，先确保「语音

热心网友

05.09

电脑教程

红米K20 Pro微信小窗模式开启与使用教程

红米K20 Pro微信小窗模式全指南：无需折腾的免提多任务方案 想一边刷资讯、看视频，一边随时回复微信消息？对于红米K20 Pro的用户来说，这事儿根本不用等系统更新，也无需下载任何第三方插件。它出厂就自带了一套相当成熟的微信小窗解决方案，完美集成在MIUI 11及后续版本中。无论是快速回复消息，还

热心网友

05.09