Spring Boot中按角色查询关联用户列表的JPA实现方法

1. 编写UserRepository正确查询逻辑 #

你不需要在JPQL中手动操作user_roles中间表，JPA会根据你配置的@ManyToMany映射自动处理中间表关联，直接通过实体属性关联即可。修正后的Repository代码如下：

package com.gestionAbscences.repository;

import com.gestionAbscences.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;

import java.util.List;

public interface UserRepository extends JpaRepository<User,Long> {

  /**
   * 根据角色ID查询关联的所有用户
   * @param roleId 角色ID
   * @return 对应用户列表
   */
  @Query("SELECT DISTINCT u FROM User u JOIN u.roles r WHERE r.id = :roleId")
  List<User> findUserByRole(@Param("roleId") int roleId);
}

注意事项：

• 加DISTINCT是为了避免一个用户拥有多个角色时，join查询返回重复的用户记录
• 方法参数必须加@Param注解指定参数名，和JPQL里:roleId的命名对应，避免Spring Data JPA参数绑定失败
• 如果需要返回用户的时候同时带出角色信息，避免懒加载序列化报错，把JOIN改成JOIN FETCH即可：

  @Query("SELECT DISTINCT u FROM User u JOIN FETCH u.roles r WHERE r.id = :roleId")
  

2. 修正现有代码的错误 #

你当前的AdminController路径映射写法有误：

• 错误写法：@GetMapping("/users?={role}")，Spring MVC不需要把查询参数写在@GetMapping的路径值里，直接映射基础路径即可，@RequestParam会自动捕获URL上的查询参数。
  修正后的Controller方法：

@GetMapping("/users")
public List<User> getUsers(@RequestParam int role){
   return userService.getUsersByRole(role);
}

3. 可选优化：按角色枚举值查询 #

如果不想依赖数据库里的角色自增ID（避免初始化数据时ID变动导致查询出错），可以直接按ERole枚举值查询，新增对应Repository方法即可：

@Query("SELECT DISTINCT u FROM User u JOIN u.roles r WHERE r.name = :roleName")
List<User> findUserByRoleName(@Param("roleName") ERole roleName);

调用时直接传入枚举值比如ERole.ETUDIANT就能查询对应角色的用户，稳定性更高。

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