Spring Data JPA多对多关系下@Query查询的正确实现方法

DevOps 小满

2026-5-28

解决Spring Data JPA中按角色ID查询启用用户的问题

嘿，你碰到的auth_user is not mapped报错完全在点子上——JPQL是基于实体类名和属性名来编写的，根本不认数据库的表名和字段名。虽然中间表user_role没有对应的实体，但你完全可以借助OAuthUser和Role已经定义好的多对多关联来实现需求，不用直接碰中间表。

下面给你两种靠谱的实现方式：

方式一：利用实体关联直接查询（首推）

既然OAuthUser里已经有了roles集合属性，直接通过这个关联过滤角色ID，再加上启用状态的条件就行，框架会自动处理中间表的关联逻辑：

@Query("SELECT u FROM OAuthUser u WHERE u.isEnabled = true AND EXISTS (SELECT r FROM u.roles r WHERE r.id = ?1)")
public List<OAuthUser> findByRole(int roleID);

或者更简洁的关联写法：

@Query("SELECT u FROM OAuthUser u JOIN u.roles r WHERE u.isEnabled = true AND r.id = ?1")
public List<OAuthUser> findByRole(int roleID);

这种写法完全贴合你的实体模型，不用操心中间表的细节，维护起来也更方便。

方式二：子查询写法（需额外实体或原生SQL）

如果你偏好子查询的风格，要么得给中间表user_role建个对应的UserRole实体，然后这么写：

@Query("SELECT u FROM OAuthUser u WHERE u.isEnabled = true AND u.id IN " +
       "(SELECT ur.user.id FROM UserRole ur WHERE ur.role.id = ?1)")
public List<OAuthUser> findByRole(int roleID);

要么就用原生SQL查询（加上nativeQuery = true），直接用数据库表名和字段，但这种写法会失去JPA的ORM优势，除非特殊需求不推荐：

@Query(value = "SELECT u.* FROM auth_user u WHERE u.is_enabled = true AND u.id IN " +
               "(SELECT r.user_id FROM user_role r WHERE r.role_id = ?1)", nativeQuery = true)
public List<OAuthUser> findByRole(int roleID);