如何在JPA原生查询中获取别名字段并映射到实体对象

我来帮你搞定这个问题！你遇到的核心问题是：JPA默认只会把查询结果映射到实体的持久化字段（也就是对应数据库列的字段），而avaialbeCount是你通过聚合函数计算出来的别名，没有对应的数据库列，直接用Hotel实体接收的话，JPA不知道怎么处理这个额外的字段。下面给你两种实用的解决方案：

方案一：使用@SqlResultSetMapping映射到实体 #

这种方法适合你需要直接返回Hotel实体的场景，步骤如下：

1. 修改Hotel实体：
   • 给avaialbeCount添加@Transient注解，告诉JPA这个字段不是数据库列
   • 添加@SqlResultSetMapping，指定查询结果如何映射到实体字段
   • 补充OneToMany的mappedBy属性（否则JPA会生成错误的关联关系）

@Entity
@Table(name = "hotels")
@SqlResultSetMapping(
    name = "HotelWithCountMapping",
    entities = @EntityResult(
        entityClass = Hotel.class,
        fields = {
            @FieldResult(name = "hotelId", column = "id"),
            @FieldResult(name = "hotelName", column = "hotel_name"),
            @FieldResult(name = "avaialbeCount", column = "avaialbeCount")
        }
    )
)
public class Hotel {
    @Id
    @Column(name = "id")
    private int hotelId;
    
    @Column(name = "hotel_name")
    private String hotelName;
    
    @OneToMany(mappedBy = "hotel") // 对应Availability实体中的hotel关联字段
    private List<Availability> list;
    
    @Transient // 标记为非持久化字段
    private int avaialbeCount;

    // JPA必须的无参构造函数
    public Hotel() {}

    // 可选：添加带参数的构造函数，方便手动创建实例
    public Hotel(int hotelId, String hotelName, int avaialbeCount) {
        this.hotelId = hotelId;
        this.hotelName = hotelName;
        this.avaialbeCount = avaialbeCount;
    }

    // 所有字段的getter和setter
    public int getHotelId() { return hotelId; }
    public void setHotelId(int hotelId) { this.hotelId = hotelId; }
    public String getHotelName() { return hotelName; }
    public void setHotelName(String hotelName) { this.hotelName = hotelName; }
    public List<Availability> getList() { return list; }
    public void setList(List<Availability> list) { this.list = list; }
    public int getAvaialbeCount() { return avaialbeCount; }
    public void setAvaialbeCount(int avaialbeCount) { this.avaialbeCount = avaialbeCount; }
}

2. 修改Repository查询：
   • 修正group by子句：必须包含所有非聚合字段（酒店的id和name），否则会返回重复的酒店数据
   • 指定resultSetMapping为我们定义的映射名称

public interface HotelRepository extends JpaRepository<Hotel, Integer>{
    @Query(
        value = "select h.id, h.hotel_name, count(a.id) as avaialbeCount from hotels h INNER JOIN availability a on a.hotel_id = h.id group by h.id, h.hotel_name",
        nativeQuery = true,
        resultSetMapping = "HotelWithCountMapping"
    )
    List<Hotel> getHotels();
}

方案二：使用自定义DTO（推荐用于只读查询） #

如果这个查询只是用于展示数据，不需要修改实体状态，用DTO（数据传输对象）会更清爽，避免污染实体类：

1. 创建DTO类：
   构造函数的参数顺序要和查询语句中字段的顺序完全一致

public class HotelCountDTO {
    private int hotelId;
    private String hotelName;
    private int avaialbeCount;

    // 构造函数参数顺序匹配select的字段顺序
    public HotelCountDTO(int hotelId, String hotelName, int avaialbeCount) {
        this.hotelId = hotelId;
        this.hotelName = hotelName;
        this.avaialbeCount = avaialbeCount;
    }

    // 只读场景只需要getter方法
    public int getHotelId() { return hotelId; }
    public String getHotelName() { return hotelName; }
    public int getAvaialbeCount() { return avaialbeCount; }
}

2. 修改Repository方法：
   直接返回DTO列表，Spring Data JPA会自动映射查询结果到DTO的构造函数

public interface HotelRepository extends JpaRepository<Hotel, Integer>{
    @Query(
        value = "select h.id as hotelId, h.hotel_name as hotelName, count(a.id) as avaialbeCount from hotels h INNER JOIN availability a on a.hotel_id = h.id group by h.id, h.hotel_name",
        nativeQuery = true
    )
    List<HotelCountDTO> getHotels();
}

额外注意点 #

• 你之前的group by a.date是错误的：这样会按日期分组，返回同一个酒店多条数据（每个日期一条），应该按酒店的唯一标识（id和name）分组，确保每个酒店只返回一条数据
• OneToMany注解必须指定mappedBy，否则JPA会自动生成一张中间关联表，导致关联逻辑错误

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