使用Hibernate关联多表查询仅返回指定业务字段（不含冗余主键）的实现方案

原代码存在的核心问题 #

• 实体关联关系存在基础错误：原User、Books实体把@OneToMany注解错标在主键字段上，UserBooks实体的关联类名和实际定义的Books类名不匹配，关联属性缺少分号，这些问题会直接导致查询解析失败
• JPQL语法逻辑错误：
  • 查询路径写错：UserBooks实体本身没有userName、bookName属性，这两个值属于关联的User、Books实体，原代码直接从ub上取这两个字段，JPA会直接报属性找不到
  • JOIN写法错误：JPA关联查询是按实体定义的属性名关联，原代码写的JOIN ub.User、JOIN ub.Book不符合属性名命名规则（实体属性是小写开头的user、book）
  • 缺少分组逻辑：没有对用户维度做聚合，查询结果会是一行一条用户-书籍的关联记录，无法拼成“单用户+对应书籍列表”的结构
  • 返回值承接对象错误：用UserBooks实体做返回值，会自动带上关联的所有字段，无法排除userId、bookId这类不需要的ID字段

具体实现步骤 #

1. 定义投影承接查询结果 #

不需要额外写DTO类，直接在Repository层定义接口投影，只会映射我们需要的两个字段，天然不会返回无关的ID信息：

// 放在Repository同包下即可
interface UserBookInfoProjection {
    String getUserName();
    List<String> getBooks();
}

2. 编写正确的JPQL查询语句 #

public interface MyRepository extends JpaRepository<UserBooks, Integer> {
    @Query("SELECT u.userName AS userName, " +
           "COLLECT(b.bookName) AS books " +
           "FROM UserBooks ub " +
           "JOIN ub.user u " +
           "JOIN ub.book b " +
           "WHERE u.userId = :userId " +
           "GROUP BY u.userName")
    UserBookInfoProjection findUserBookInfo(Integer userId);
}

语句说明：

• 关联查询严格按UserBooks实体里定义的user、book关联属性走，不需要手动写表关联条件，JPA会自动识别外键映射关系
• 用COLLECT聚合函数把当前用户关联的所有书籍名称收集成列表，直接对应需要的books数组结构
• 按userName分组，保证单个用户只返回一条记录，不会出现重复的用户条目
• 整个查询只取需要的两个字段，SQL层面就不会查询userId、bookId，序列化时自然不会返回这两个字段

最终返回效果 #

查询结果经过Spring默认的JSON序列化后，会直接得到符合要求的结构：

{
   "userName": "jamesbond007",
   "books": [
       "Cat In the Hat",
       "Green Eggs and Ham"
   ]
}

注意：原示例JSON中Green Eggs and Ham字段缺少闭合引号，实际开发时要注意语法合规。

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