如何编写通过@ElementCollection与@MapKeyJoinColumn关联的JPQL查询

咱们先来拆解下你遇到的问题：你的Document用Map<Group, AccessMode>映射了和GROUPS的关联（通过中间表DOCUMENTS_GROUPS），而Group和User是常规的@ManyToMany关系。你原来的JPQL查询在关联Group的members时踩了JPQL语法的坑，咱们一步步来修正。

错误原因分析 #

当你写INNER JOIN d.groups g的时候，这里的g其实是Map.Entry<Group, AccessMode>类型的对象（而不是直接的Group实体）。JPQL不允许直接在JOIN语句里嵌套KEY(g).members这种写法，这就是第一个查询报错的原因；而你尝试的INNER JOIN g.members m会报错，是因为g是Map.Entry，它本身并没有members属性——members属于Group，也就是Map的key。

正确的JPQL写法 #

你需要先把Map的key（也就是Group实体）单独关联出来，赋予一个别名后，再去关联它的members集合。这里有两种等价的写法：

写法一：通过KEY(g)关联Group

SELECT d FROM Document d 
INNER JOIN d.groups g 
INNER JOIN KEY(g) grp 
INNER JOIN grp.members m 
WHERE m.id = :userId

写法二：通过entrySet()获取Map条目

SELECT d FROM Document d 
INNER JOIN d.groups.entrySet() entry 
INNER JOIN entry.key grp 
INNER JOIN grp.members m 
WHERE m.id = :userId

为什么这样写能解决问题？ #

• 第一种写法里，INNER JOIN KEY(g) grp把Map.Entry对应的Group实体取出来，赋予别名grp，之后就可以正常关联grp.members了；
• 第二种写法更直观，直接通过entrySet()获取所有Map条目，然后从entry.key拿到Group实体，后续关联逻辑和第一种一致。

这两种写法都能正确绕过JPQL对Map关联的语法限制，顺利实现跨表查询。

内容的提问来源于stack exchange，提问作者Sebastian S