如何将含CASE WHEN的原生SQL转为JPQL/HQL并适配Specification？

我定义了如下Event实体：

@Data
@Entity
@Table(name = "event")
@DynamicInsert
@AllArgsConstructor
@NoArgsConstructor
@EqualsAndHashCode
public class Event {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "accountable_unit_id")
    private Long accountableUnitId;

    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "type_id")
    private EventType type;

    @Column(name = "name")
    private String name;

    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "status_id")
    @Enumerated(EnumType.STRING)
    private EventStatus status;

    @Column(name = "user_info")
    private String userInfo;

    @Column(name = "deadline_dttm")
    private Instant deadlineOn;

    @Column(name = "completed_dttm")
    private Instant completedOn;

    @Column(name = "status_modify_dttm")
    private Instant statusUpdatedOn;

    @Column(name = "create_dttm")
    private Instant createdOn;

    @Column(name = "modify_dttm")
    private Instant updatedOn;

    @Version
    @Column(name = "version")
    private int version;

    @Column(name = "status_name")
    private String statusName;
}

同时在EventRepository中定义了如下方法：

@Repository
public interface EventRepository extends JpaRepository<Event, Long>, JpaSpecificationExecutor<Event> {
    @Query(value = "select e.*,\n" +
            " CASE \n" +
            " WHEN es.code = 'in_progress' and e.deadline_dttm < now()\n" +
            " THEN 'Просрочено' \n" +
            " ELSE es.\"name\"\n" +
            " END status_name  \n" +
            "from public.\"event\" e join public.event_status es on e.status_id = es.id",
            countQuery = "select count(*) from public.\"event\"",
            nativeQuery = true)
    Page<Event> findAllWithDynamicStatusName(Specification<Event> spec, Pageable pageable);
}

遇到的问题：Specification无法与原生查询配合使用，希望将原生SQL改写为JPQL/HQL（曾误以为JPQL不支持CASE WHEN），或找到让Specification与原生查询兼容的方案。

方案一：用JPQL改写查询（JPQL完全支持CASE WHEN） #

JPQL/HQL原生支持CASE WHEN语法，结合实体关联关系可轻松改写查询，同时保留Specification的支持：

步骤1：修正实体注解冲突 #

Event实体中status字段的@ManyToOne（关联实体）与@Enumerated（枚举类型）注解冲突，需二选一。假设EventStatus是对应event_status表的实体（包含id、code、name字段），则去掉@Enumerated注解：

@ManyToOne(fetch = FetchType.EAGER)
@JoinColumn(name = "status_id")
private EventStatus status;

步骤2：改写为JPQL查询 #

修改EventRepository中的方法为JPQL版本，直接支持Specification：

@Repository
public interface EventRepository extends JpaRepository<Event, Long>, JpaSpecificationExecutor<Event> {
    @Query("SELECT e, CASE WHEN e.status.code = 'in_progress' AND e.deadlineOn < CURRENT_TIMESTAMP THEN 'Просрочено' ELSE e.status.name END AS statusName FROM Event e")
    Page<Object[]> findAllWithDynamicStatusName(Specification<Event> spec, Pageable pageable);
}

更简洁的替代方案：使用@Formula自动计算字段 #

若希望直接返回填充好statusName的Event实体，可在实体字段上添加@Formula注解，让Hibernate自动计算该字段值：

@Column(name = "status_name", insertable = false, updatable = false)
@Formula("CASE WHEN (SELECT es.code FROM event_status es WHERE es.id = status_id) = 'in_progress' AND deadline_dttm < now() THEN 'Просрочено' ELSE (SELECT es.name FROM event_status es WHERE es.id = status_id) END")
private String statusName;

此时无需自定义查询，直接使用JPA自带方法即可结合Specification：

Page<Event> findAll(Specification<Event> spec, Pageable pageable);

方案二：让Specification与原生查询兼容（不推荐） #

JPA的Specification基于JPQL抽象，无法直接与原生查询配合。若坚持使用原生查询，需手动将Specification转换为原生SQL的WHERE子句：

• 利用CriteriaBuilder将Specification转换为CriteriaQuery，再通过Hibernate内部API提取生成的SQL片段。
• 将SQL片段拼接到原生查询中，手动处理参数绑定。
• 自行构建分页逻辑，处理count查询和分页参数。

该方式依赖Hibernate内部API，代码复杂度高、可维护性差，不推荐使用。

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