原生查询在H2可获结果但JPA Repository无返回的问题排查

看起来你的问题主要出在查询逻辑缺失关键过滤条件、JPA实体配置与实际表结构不匹配这两个核心点上，下面一步步拆解并给出修正方案：

1. 最致命的问题：查询没有针对当前用户过滤 #

你的需求是“获取当前用户所代理的用户列表”，但你写的JPA查询完全没有限定当前用户的ID——也就是说，这个查询会返回所有存在代理关系的被代理人ID，而不是针对某个特定用户的结果。如果你的数据库里没有全局的代理关系，或者你期望的是某个用户的专属代理列表，自然会返回空。

2. 实体配置与表结构的潜在不匹配 #

你提到关联表是USER_REPRESENTATIVES，但你的User实体类的@ManyToMany注解没有显式指定关联表和字段映射。JPA（比如Hibernate）默认会自动生成自关联的中间表，命名和字段可能和你手动创建的USER_REPRESENTATIVES不一致，导致查询时找不到对应数据。

修正步骤 #

第一步：补全实体类的关联表配置 #

在representatives字段上添加@JoinTable注解，和你的实际表结构完全对齐：

data class User(
    @Id var userId: UUID,
    val orgId: UUID,
    @ManyToMany
    @JoinTable(
        name = "USER_REPRESENTATIVES", // 指定关联表名
        joinColumns = [JoinColumn(name = "USER_USER_ID")], // 当前用户的外键字段
        inverseJoinColumns = [JoinColumn(name = "REPRESENTATIVES_USER_ID")] // 代理人的外键字段
    )
    var representatives: MutableList<User>
)

第二步：修正Repository的查询方法 #

添加当前用户ID的参数，并过滤出该用户作为代理人的被代理人列表，同时去掉多余的EXISTS子句（因为外键约束已经保证REPRESENTATIVES_USER_ID一定存在于USER表中）：

@Query(value = "SELECT USER_USER_ID FROM USER_REPRESENTATIVES " +
    "WHERE REPRESENTATIVES_USER_ID = :currentUserId", nativeQuery = true)
fun getUsersRepresentedBy(currentUserId: UUID): MutableList<UUID>

如果你不想用原生查询，也可以用更符合JPA风格的JPQL：

@Query("SELECT u.userId FROM User u JOIN u.representatives r WHERE r.userId = :currentUserId")
fun getUsersRepresentedBy(currentUserId: UUID): MutableList<UUID>

为什么这样改？ #

• 新增的currentUserId参数精准定位了当前用户，确保只返回该用户代理的用户列表；
• @JoinTable配置让JPA明确知道要使用你手动创建的关联表，避免默认生成的表结构和实际表不匹配；
• 去掉多余的EXISTS子句简化了查询逻辑，提升了效率。

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