Hibernate 6自定义H2 Dialect：Null排序优先级失效问题

可能的操作误区 #

在Hibernate 6中，getNullOrdering()方法定义的是全局默认的NULL排序规则，但它仅在JPQL查询未显式指定NULLS FIRST/LAST时生效，且需要结合Hibernate的SQL生成逻辑。如果你的查询未生成NULLS LAST，可能存在以下问题：

1. 未匹配查询的排序方向 #

getNullOrdering()返回的规则对应**升序（ASC）**场景的默认行为，若查询是降序（DESC），Hibernate会自动反转该规则（即NullOrdering.LAST对应降序时的NULLS FIRST）。如果需要全局统一所有排序方向都应用NULLS LAST，仅覆写getNullOrdering()是不够的。

2. 自定义Dialect的实现逻辑不完整 #

Hibernate 6对Dialect的SQL生成逻辑做了大量重构，部分数据库的Dialect可能会覆盖默认的NULL排序处理。仅覆写getNullOrdering()可能无法覆盖所有场景的SQL生成逻辑。

可行的解决方法 #

方法一：通过配置属性全局设置（更简单） #

无需自定义Dialect，直接在Spring Boot配置文件中添加：

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

该配置会全局生效，所有未显式指定NULL排序的JPQL查询都会自动追加NULLS LAST。

方法二：完善自定义Dialect的实现 #

如果必须通过自定义Dialect实现，除了覆写getNullOrdering()，还可以覆写Hibernate 6中重构后的renderOrderByElement方法，强制指定NULL排序规则：

public class ExtendedH2Dialect extends H2Dialect {
    @Override
    public NullOrdering getNullOrdering() {
        return NullOrdering.LAST;
    }

    @Override
    public void renderOrderByElement(
            SqlAppender sqlAppender,
            String expression,
            String collate,
            OrderingSpecification ordering,
            NullPrecedence nullPrecedence,
            boolean isAscending) {
        // 强制使用NULLS LAST，忽略传入的nullPrecedence参数
        super.renderOrderByElement(sqlAppender, expression, collate, ordering, NullPrecedence.LAST, isAscending);
    }
}

方法三：显式在JPQL中指定NULL排序 #

如果仅针对部分查询生效，可以直接在JPQL中添加NULLS LAST，比如：

SELECT e FROM Entity e ORDER BY e.name ASC NULLS LAST

验证步骤 #

1. 检查Hibernate生成的SQL日志，确认排序子句是否包含NULLS LAST；
2. 确认自定义Dialect已被正确加载（日志中会输出使用的Dialect类名）；
3. 测试不同排序方向的查询，验证NULL排序规则是否符合预期。

内容的提问来源于stack exchange，提问作者antoine.lange