JPQL嵌套Join Fetch查询用户权限报错，求正确实现方案

错误原因 #

你遇到的SemanticException是因为Hibernate的join fetch规则：使用join fetch加载关联实体时，被fetch关联的所有者必须出现在SELECT列表中。你的查询里用了left join fetch u.roles r，这个关联的所有者是u（User实体），但SELECT只取了p（Privilege），不符合Hibernate的语义要求，所以报错。

正确实现方式 #

方式1：直接查询权限（推荐，无需加载关联实体） #

去掉fetch关键字，改用普通join，同时添加distinct去重（避免同一权限被多个角色重复返回）：

@Query("select distinct p from User u join u.roles r join r.privileges p where u.email = :email")
fun getAllByUserEmail(email: String): Set<Privilege>

• 这里用join而非left join，因为如果用户没有角色/权限，返回空集合更符合业务逻辑；如果需要保留左连接（即使无权限也返回空），可以改成left join。
• distinct用于过滤重复的Privilege记录，多对多关联会产生笛卡尔积，导致同一权限被多次查询出来。

方式2：加载用户关联后提取权限 #

如果需要同时加载User和Role的关联关系（比如后续要用到用户的角色信息），可以先查询带关联的User，再在业务层提取权限：

@Query("select u from User u left join fetch u.roles r left join fetch r.privileges p where u.email = :email")
fun getUserWithAllPrivileges(email: String): User?

然后在业务代码中提取权限：

val user = userRepository.getUserWithAllPrivileges("user@example.com")
val privileges = user?.roles?.flatMap { it.privileges.orEmpty() }?.toSet() ?: emptySet()

补充修复建议 #

你的Role实体缺少@Id注解，这会导致Hibernate无法识别主键，建议给Role添加主键配置（因为关联表中用的是Role的NAME作为外键）：

@Entity
@Table(name = "roles")
data class Role(
    @Id
    var name: String? = null,

    @ManyToMany
    @JoinTable(
        name = "roles_privileges",
        joinColumns = [JoinColumn(name = "ROLE_ID", referencedColumnName = "NAME")],
        inverseJoinColumns = [JoinColumn(name = "PRIVILEGE_ID", referencedColumnName = "NAME")]
    )
    var privileges: Set<Privilege>? = null
)

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