HQL语法异常：interval关键字报错及指定查询语句问题咨询

原因分析 #

你遇到的QuerySyntaxException核心原因很明确：HQL不支持直接使用数据库原生的interval语法。HQL是Hibernate的跨数据库查询语言，有自己独立的函数规范，而date_add(:from,interval 1 DAY)是MySQL（或类似关系型数据库）的原生SQL写法，HQL的语法解析器根本不认识interval这个标记，所以直接抛出了语法异常。

解决办法 #

给你三个可行的方案，按推荐程度排序：

1. 在代码中计算结束日期（最推荐）

直接在业务代码里把from日期加上1天，作为新参数传入查询，完全避免在HQL里处理日期计算，既简洁又跨数据库：

// 修改业务调用逻辑，先计算结束时间
fun findFirstSingnedReceiptByFrom(rk: CashRegister, from: DateTime): SignedReceipt? {
    val endDate = from.plusDays(1)
    return yourRepository.findFirstSingnedReceiptByRange(rk, from, endDate)
}

// 修改Repository层的查询方法
@Query("SELECT sr FROM SignedReceipt sr where sr.cashBox_id=:rk and sr.since between :from and :endDate order by sr.since limit 1")
fun findFirstSingnedReceiptByRange(
    @Param("rk") rk: CashRegister,
    @Param("from") from: DateTime,
    @Param("endDate") endDate: DateTime
): SignedReceipt?

这个方案的优势是不依赖任何数据库特定语法，代码可维护性和兼容性都更高。

2. 使用HQL的FUNCTION调用原生日期函数

如果你想在HQL里处理日期计算，可以用HQL提供的FUNCTION函数来调用数据库原生的date_add，让Hibernate根据数据库方言正确解析：

@Query("SELECT sr FROM SignedReceipt sr where sr.cashBox_id=:rk and sr.since between :from and FUNCTION('date_add', :from, INTERVAL 1 DAY) order by sr.since limit 1")
fun findFirstSingnedReceiptByFrom(
    @Param("rk") rk: CashRegister,
    @Param("from") from: DateTime
): SignedReceipt?

注意：这个写法依赖你使用的数据库支持date_add函数（比如MySQL），如果换用其他数据库（比如PostgreSQL），需要调整函数名称和参数格式。

3. 改用原生SQL查询

如果以上方案都不适用，可以直接使用原生SQL查询，通过nativeQuery = true告诉Hibernate不要解析HQL，直接执行原生SQL：

@Query(
    value = "SELECT sr.* FROM signed_receipt sr where sr.cashBox_id=:rk and sr.since between :from and date_add(:from,interval 1 DAY) order by sr.since limit 1",
    nativeQuery = true
)
fun findFirstSingnedReceiptByFrom(
    @Param("rk") rk: CashRegister,
    @Param("from") from: DateTime
): SignedReceipt?

这个方案的缺点是和数据库强耦合，后续更换数据库时需要修改SQL语句。

内容的提问来源于stack exchange，提问作者meher ben ahmed