Spring Data JPA多对多关联查询返回全部记录而非匹配记录问题

核心原因：JPQL查询未正确关联用户与角色，或连接方式错误 #

最常见的两种错误场景：

1. 未添加用户与角色的关联条件，导致笛卡尔积 #

如果你的查询是类似这种写法：

SELECT u.username FROM AppUser u, AppRole r WHERE r.name = :roleName

这种写法会生成用户表和角色表的笛卡尔积——只要数据库中存在名称匹配的角色，所有用户都会被返回，因为查询没有建立用户和角色之间的关联关系（比如未指定r属于u的角色集合）。

2. 错误使用左外连接（LEFT JOIN）且未过滤空关联 #

若查询使用了左外连接但未过滤无角色的用户：

SELECT u.username FROM AppUser u LEFT JOIN u.roles r WHERE r.name = :roleName

左外连接会保留所有用户记录，当用户没有匹配角色时r为null，若JPQL逻辑未做额外过滤，会导致无角色用户也被错误返回；更常见的是误写OR条件而非AND，直接导致过滤规则失效。

正确的查询写法 #

写法一：使用内连接（JOIN）过滤匹配用户 #

内连接只会保留拥有指定角色的用户，自动排除无匹配角色的用户，加上DISTINCT避免用户拥有多个匹配角色时重复返回：

SELECT DISTINCT u.username 
FROM AppUser u 
JOIN u.roles r 
WHERE r.name = :roleName

写法二：使用MEMBER OF语法验证角色归属 #

通过子查询验证用户是否包含指定角色：

SELECT u.username 
FROM AppUser u 
WHERE EXISTS (
    SELECT r FROM AppRole r 
    WHERE r.name = :roleName AND r MEMBER OF u.roles
)

写法三：简洁的子查询判断 #

直接检查用户的角色集合中是否存在目标角色名：

SELECT u.username 
FROM AppUser u 
WHERE :roleName IN (SELECT r.name FROM u.roles r)

以上三种写法均会实现预期效果：传入User Admin返回johndoe、sam；传入Test返回sam；传入不存在的角色名返回空列表。

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