Spring JPA中Users、Roles、用户角色关联表联合查询无结果问题咨询

问题根因 #

查询无结果的核心原因是实体关联映射配置错误，导致JPA无法正确关联三张表的数据，具体错误点如下：

1. UserRoleGroup 实体中关联User的外键映射错误：中间表user_roles关联Users表的外键字段为USER_ID，但配置中写为name="id"，导致关联字段不匹配，无法找到对应关联数据。
2. 类名映射不匹配：你定义的角色实体类名为Roles，但UserRoleGroup中关联角色的属性类型为不存在的RoleGroup，导致关联逻辑失效。
3. （可选，根据实际数据库表结构判断）Roles实体的角色名称字段映射与表结构不一致：示例中Roles表的角色名称字段为Name，但实体配置的是@Column(name = "ROLE_NAME")，字段不匹配也会导致关联数据读取失败。

解决方案 #

1. 修正UserRoleGroup实体的关联配置 #

@Column(name = "USER_ID")
private int userId;

@Column(name = "ROLE_ID")
private int roleId;

// 关联角色实体，类型改为你定义的Roles，补充referencedColumnName指定关联目标表的主键
@ManyToOne()
@JoinColumn(name="ROLE_ID", referencedColumnName = "ROLE_ID", insertable = false, updatable = false)    
private Roles userRole;

// 修正User关联的外键字段名，指向中间表的USER_ID字段
@ManyToOne()
@JoinColumn(name="USER_ID", referencedColumnName = "ID", insertable = false, updatable = false)    
private User user;

2. 修正Roles实体的字段映射（按需调整） #

如果实际数据库Roles表的角色名称字段为Name，修改实体配置和表结构匹配：

@Id
@Column(name="ROLE_ID")
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
    
// 和数据库表字段保持一致
@Column(name = "Name")
private String roleName;

@OneToMany(targetEntity=UserRoleGroup.class, mappedBy="userRole",cascade=CascadeType.ALL, 
    fetch = FetchType.LAZY)    
private List<UserRoleGroup> userGroup;

3. 优化JPQL查询（可选，解决懒加载问题） #

如果需要在查询结果中直接拿到关联的User和Roles数据，避免后续懒加载异常，可在JPQL中增加FETCH关键字：

@Query("FROM UserRoleGroup AS urg LEFT JOIN FETCH urg.userRole AS ur LEFT JOIN FETCH urg.user AS u WHERE u.userName = ?1") 
public List<UserRoleGroup> findAllUserRoles(String userName);

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