Spring Boot JPA 多对多带额外字段如何查询用户兴趣及优先级？

问题根源 #

此前的findByPriority_user方法返回值为Interest实体本身，这类实体仅映射自身表的字段，不会携带中间关联表RelUserInterest中匹配对应用户的priority值，因此查询结果必然缺失优先级字段。

落地实现步骤 #

1. 基于中间关联表构建查询逻辑 #

RelUserInterest实体本身同时持有user、interest关联对象和自有的priority字段，从该实体出发查询可直接获取所有需要的字段，无需多层遍历关联集合。
首先创建RelUserInterest对应的Repository接口：

public interface RelUserInterestRepository extends JpaRepository<RelUserInterest, Long> {
}

2. 定义匹配返回结构的投影 #

为避免直接序列化关联实体带来的冗余、递归问题，定义和目标JSON结构完全匹配的接口投影：

public interface UserInterestProjection {
    Long getInterestId();
    String getNameInterest();
    Integer getPriority();
}

投影的字段命名需和后续查询的字段别名完全对应，Spring Data JPA 会自动完成结果映射。

3. 编写自定义JPQL查询 #

在RelUserInterestRepository中添加查询方法，直接从关联表取出需要的字段，映射到投影接口：

public interface RelUserInterestRepository extends JpaRepository<RelUserInterest, Long> {
    @Query("SELECT " +
           "ri.interest.id AS interestId, " +
           "ri.interest.nameInterest AS nameInterest, " +
           "ri.priority AS priority " +
           "FROM RelUserInterest ri " +
           "WHERE ri.user.id = :userId")
    List<UserInterestProjection> findUserInterestList(@Param("userId") Long userId);
}

效果说明 #

该方法返回的投影列表经JSON序列化后，完全匹配需求的返回格式：

[
 {
   "interest_id": 1,
   "name_interest": "Museum",
   "priority": 5
 },
 {
   "interest_id": 2,
   "name_interest": "Cathedral",
   "priority": 6
 }
]

如果需要调整JSON输出的字段名，可在投影接口的get方法上添加@JsonProperty注解指定输出字段名，和目标结构完全对齐即可。

注意事项 #

• 禁止直接序列化RelUserInterest实体：实体内部持有双向关联的User、Interest对象，极易触发序列化无限递归，导致JSON结构异常、响应体积过大
• 不推荐从Interest视角反查关联集合实现需求：这类写法最终返回的Interest对象会嵌套关联的RelUserInterest集合，无法匹配扁平的目标返回结构，处理逻辑冗余度高

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