Spring Boot 3/Hibernate 6中JPA仓库NULLS排序语法失效求助

针对升级后原JPQL查询抛出BadJpqlGrammarException、Sort参数NULL排序不生效的问题，提供以下无需原生SQL的解决方案：

方案1：JPQL中用CASE表达式实现NULL排序 #

利用CASE表达式手动区分NULL和非NULL值的排序优先级，完全兼容JPA规范，避免Hibernate语法校验报错：

@Query("""
    SELECT m FROM ProjectMember m
    ORDER BY CASE WHEN m.lastActive IS NULL THEN 1 ELSE 0 END, m.lastActive ASC
""")
List<ProjectMember> sortLastActiveAscNullsLast();

逻辑说明：将NULL值标记为1，非NULL标记为0，排序时先处理非NULL值（0在前），再处理NULL值（1在后），最终实现ASC NULLS LAST的效果。

方案2：利用Spring Data JPA的方法命名或Unsafe Sort #

方法命名方式 #

直接通过方法名定义排序规则，Spring Data JPA会自动生成带NULLS LAST/FIRST的SQL：

// 实现lastActive升序，NULL值排在最后
List<ProjectMember> findAllByOrderByLastActiveAscNullsLast();

// 实现lastActive降序，NULL值排在最前
List<ProjectMember> findAllByOrderByLastActiveDescNullsFirst();

Unsafe Sort参数传递 #

如果需要动态传递排序规则，使用JpaSort.unsafe强制生成包含NULL排序的SQL：

// 构造排序规则
Sort sort = JpaSort.unsafe(Sort.Direction.ASC, "lastActive NULLS LAST");
Pageable pageable = PageRequest.of(0, 10, sort);

// 调用Repository方法
List<ProjectMember> members = projectMemberRepository.findAll(pageable);

方案3：全局配置NULL排序规则 #

如果希望所有默认排序统一处理NULL值，可在配置文件中设置Hibernate全局规则：

# application.properties
spring.jpa.properties.hibernate.order_by.default_null_ordering=last

或者yaml格式：

# application.yaml
spring:
  jpa:
    properties:
      hibernate:
        order_by:
          default_null_ordering: last

可选值：last（NULL值排在末尾）、first（NULL值排在开头）、none（默认，遵循数据库原生规则）。

内容的提问来源于stack exchange，提问作者Sebastiaan van den Broek