如何通过JPA将PostgreSQL函数结果映射为TimeSlot列表？

错误原因 #

你当前使用的是HQL查询，但HQL语法不支持直接在FROM子句中调用PostgreSQL的表值函数，HQL解析器无法识别这种函数调用的语法结构，导致解析报错。

解决方案 #

1. 修改Repository查询为原生SQL #

将@Query标记为原生SQL查询，直接调用PostgreSQL函数，让JPA自动映射结果到TimeSlot类。需要注意以下几点：

• 设置nativeQuery=true
• 确保TimeSlot类有匹配参数顺序的构造函数（构造函数方式的映射更可靠）
• 函数调用的参数要正确对应占位符

2. 调整后的代码示例 #

完善TimeSlot类（添加对应构造函数）

public class TimeSlot {
    private Timestamp t_start;
    private Timestamp t_end;

    // 必须添加与查询结果字段顺序匹配的构造函数
    public TimeSlot(Timestamp t_start, Timestamp t_end) {
        this.t_start = t_start;
        this.t_end = t_end;
    }

    // 可选：添加无参构造函数（适配JPA其他映射场景）
    public TimeSlot() {}

    // Getter和Setter方法
    public Timestamp getT_start() {
        return t_start;
    }

    public void setT_start(Timestamp t_start) {
        this.t_start = t_start;
    }

    public Timestamp getT_end() {
        return t_end;
    }

    public void setT_end(Timestamp t_end) {
        this.t_end = t_end;
    }
}

修改Repository的查询方法

public interface WorkstationReservationRepository extends ReservationBaseRepository<WorkstationReservation>{

    @Query(
        value = "SELECT t_start, t_end FROM getFirstNAvailableSlots(:N, :t_start, :t_end, :cpu, :max_reservable_cpu)",
        nativeQuery = true
    )
    List<TimeSlot> getFirstNAvailableSlots(
        @Param("N") int N,
        @Param("t_start") Timestamp t_start,
        @Param("t_end") Timestamp t_end,
        @Param("cpu") int cpu,
        @Param("max_reservable_cpu") int max_reservable_cpu
    );

}

3. 补充说明 #

• 由于TimeSlot的字段名和函数返回的列名完全一致（t_start和t_end），JPA会自动完成映射；如果字段名不匹配，可以用@ColumnResult配合@SqlResultSetMapping指定映射关系，本场景无需额外配置。
• 原生SQL查询会直接发送给PostgreSQL执行，避开HQL的语法限制，完美适配PostgreSQL表值函数的调用逻辑。

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