QueryDSL四舍五入语法解析错误：按生日季度排序失败

问题分析 #

你遇到的核心问题：

1. 使用month().divide(3).ceil()时，EclipseLink的JPQL解析器无法识别ORDER BY中的ceil()表达式，抛出语法错误。
2. 直接使用QUARTER({0})模板时，不符合JPQL规范，EclipseLink无法解析该函数调用。
3. 移除ceil()后，整数除法month/3会导致季度计算错误（比如3月得到1，4月也得到1，排序混乱）。

解决方案 #

方案1：用整数运算替代ceil()（推荐，无需依赖数据库函数）

通过(月份 + 2) ÷ 3的整数运算，直接得到正确的季度值，完全避免ceil()函数：

List<Person> sortedPersons = query.selectFrom(person)
    .orderBy(
        // (month + 2) 后做整数除法，1-3月→1，4-6月→2，以此类推
        person.birthday.value.month().add(2).divide(3, Integer.class).asc()
    )
    .fetch();

原理：整数除法会自动向下取整，(month + 2)/3刚好等价于ceil(month/3)：

• 1-3月：(1+2)/3=1，(3+2)/3=5/3=1
• 4-6月：(4+2)/3=2，(6+2)/3=8/3=2
• 以此类推，完美匹配季度划分。

方案2：使用EclipseLink支持的FUNCTION模板调用数据库QUARTER函数

如果需要直接调用数据库的QUARTER函数，必须用JPQL的FUNCTION语法包裹，EclipseLink才能正确解析：

List<Person> sortedPersons = query.selectFrom(person)
    .orderBy(
        Expressions.numberTemplate(Integer.class, "FUNCTION('QUARTER', {0})", person.birthday.value).asc()
    )
    .fetch();

原理：EclipseLink要求通过FUNCTION关键字调用数据库原生函数或扩展函数，直接写QUARTER({0})会被视为无效JPQL表达式。

错误原因说明 #

• 第一种写法的错误：EclipseLink的JPQL解析器对ORDER BY子句中的数学函数支持有限，ceil()函数无法被正确解析为合法的排序表达式。
• 第二种模板写法的错误：未遵循JPQL规范调用数据库函数，必须用FUNCTION包裹才能让EclipseLink识别并转换为对应的数据库SQL。

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