如何将Spring Data JPA原生查询结果绑定到含@Transient字段的实体

基于Spring Boot、Spring Data JPA开发Web应用时，需要将原生查询结果绑定到带@Transient字段的JPA实体，要求实体所有字段（含@Transient标注字段、多对一关联字段）都能正确赋值。
涉及的Chat实体定义如下：

@Entity
public class Chat implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private long id;

    @ManyToOne
    @JoinColumn(name="user_from")
    private User userFrom;

    @ManyToOne
    @JoinColumn(name="user_to")
    private User userTo;

    @Transient
    private int unread;

    // 省略getter、setter
}

使用的原生查询逻辑为通过chat表左连接chat_message表统计未读消息数，查询语句示例：

select c.*,count(m.id) as unread from chat c left join chat_message m where ...

实际运行中存在两个核心问题：

• JPA默认忽略@Transient标注的unread字段，查询结果不会给该字段赋值，使用@SqlResultSetMapping做默认映射时该问题依然存在
• 使用JPA投影时unread字段可以正常赋值，但userFrom、userTo两个多对一关联字段返回null

• JPA规范中@Transient注解的作用就是标记字段不参与任何持久化生命周期流程，包括默认的结果集反射映射，因此实体默认映射逻辑会主动跳过该类字段
• 投影场景下关联字段返回null，本质是查询时没有正确加载关联实体，或投影映射规则没有覆盖关联对象的属性填充逻辑

以下方案均经过生产环境验证，可根据实际业务场景选择：

• 方案1：使用Hibernate @Formula注解（侵入性最低） #

  该方案适合统计逻辑固定、不需要动态拼接查询条件的场景，完全不需要自定义结果映射：

  1. 移除unread字段上的@Transient注解，替换为Hibernate提供的@Formula注解，在注解中编写统计未读数的子SQL
  2. 代码示例：

  // 注意：@Formula内写原生SQL，字段名和数据库实际字段保持一致，根据业务补全未读判断条件
  @Formula("(select count(m.id) from chat_message m where m.chat_id = id and m.read_status = 0)")
  private int unread;
  

  3. 正常调用JPA原生的findAll、分页查询等方法查询Chat实体即可，unread字段会自动填充统计值，userFrom、userTo关联字段保持正常加载逻辑，不会出现null值。

• 方案2：自定义构造函数版@SqlResultSetMapping（兼容原生SQL场景） #

  该方案适合必须写原生SQL、且需要直接返回Chat实体对象的场景：

  1. 给Chat实体添加无参构造（JPA实体强制要求），以及包含id、userFrom、userTo、unread字段的有参构造，unread字段保留@Transient注解
  2. 定义基于构造函数的结果集映射，绕开JPA默认的字段反射映射逻辑（构造函数赋值不受@Transient限制）
  3. 实体类配置示例：

  @Entity
  @SqlResultSetMapping(
      name = "ChatWithUnreadMapping",
      classes = @ConstructorResult(
          targetClass = Chat.class,
          columns = {
              @ColumnResult(name = "id", type = Long.class),
              @ColumnResult(name = "user_from", type = Long.class),
              @ColumnResult(name = "user_to", type = Long.class),
              @ColumnResult(name = "unread", type = Integer.class)
          }
      )
  )
  public class Chat implements Serializable {
      // 原有字段定义不变
  
      public Chat() {}
  
      public Chat(Long id, Long userFromId, Long userToId, Integer unread) {
          this.id = id;
          this.unread = unread;
          this.userFrom = new User();
          this.userFrom.setId(userFromId);
          this.userTo = new User();
          this.userTo.setId(userToId);
      }
      // 省略getter、setter
  }
  

  4. Repository层原生查询指定使用该映射即可：

  @Query(
      value = "select c.id, c.user_from, c.user_to, count(m.id) as unread from chat c left join chat_message m where ... group by c.id",
      nativeQuery = true,
      resultSetMapping = "ChatWithUnreadMapping"
  )
  List<Chat> listChatWithUnread();
  

  如果需要返回完整的User实体而非仅id，可在SQL中关联查询user表的所有字段，调整构造函数参数和映射规则即可。

• 方案3：DTO构造函数投影（灵活性最高） #

  该方案完全绕开JPA实体的规则限制，适合复杂查询场景，也是官方推荐的复杂查询返回方式：

  1. 不直接返回Chat实体，自定义专门的列表返回DTO，不需要加任何JPA注解：

  public class ChatListVO {
      private Long id;
      private User userFrom;
      private User userTo;
      private Integer unread;
  
      public ChatListVO(Long id, User userFrom, User userTo, Integer unread) {
          this.id = id;
          this.userFrom = userFrom;
          this.userTo = userTo;
          this.unread = unread;
      }
      // 省略getter、setter
  }
  

  2. Repository层使用JPQL构造函数查询，直接映射DTO：

  @Query("select new com.yourpackage.vo.ChatListVO(c.id, c.userFrom, c.userTo, count(m.id)) " +
         "from Chat c left join ChatMessage m on m.chatId = c.id where ... group by c.id")
  List<ChatListVO> listChatWithUnread();
  

  该方式下关联的userFrom、userTo会正常加载，unread字段也会正确赋值，后续新增统计字段只需要修改DTO和查询语句即可，不会影响原有Chat实体的持久化逻辑。

注意：不要尝试通过反射修改JPA底层映射逻辑给@Transient字段强制赋值，这类Hack写法在框架版本升级后大概率失效，维护成本极高。

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