Grails 7：如何规避遗留Hibernate Criteria查询及GORM适配建议

一、废弃提示在Grails/GORM层面的影响 #

Grails GORM底层默认基于Hibernate实现，Hibernate官方标记Criteria API废弃的变动会直接传导到GORM层面：

• 当前Grails 7版本中，旧的Criteria查询仍可正常运行，但会持续抛出废弃警告，提示该API后续版本会被移除。
• 若后续升级到Grails 8及更高版本，这些废弃的Criteria API很大概率会被直接移除，届时依赖旧代码的查询会直接报错。
• 由于Hibernate不再维护Criteria API，后续Hibernate版本的兼容性问题（如复杂查询的行为变化、bug不再修复）会直接影响GORM的旧Criteria查询，稳定性无法保障。

二、是否需要了解GORM的实现机制 #

不需要深入到源码级别的实现细节，但需要明确GORM是对Hibernate等ORM框架的封装这一核心关系：

• 明白这一点后，就能理解为什么Hibernate的API废弃会影响GORM，也能更清晰地判断哪些GORM查询方式是长期稳定的。
• 只需了解不同GORM查询方式对应的底层Hibernate API（比如Query DSL对应Hibernate的CriteriaQuery，HQL对应Hibernate的HQL解析器），就足以选择合适的替代方案，无需深挖具体实现逻辑。

三、应选用或规避的GORM查询方式 #

需规避的方式 #

• 彻底放弃传统的createCriteria()方法及基于HibernateCriteriaBuilder的闭包式查询，比如：

  // 需规避的旧写法
  def results = Book.createCriteria().list {
      eq("title", "Grails in Action")
      author {
          eq("lastName", "Brown")
      }
  }
  

• 避免使用DetachedCriteria的复杂嵌套逻辑，尤其是依赖Hibernate Criteria特有方法的场景。

推荐选用的方式 #

• GORM Query DSL：这是Grails官方主推的替代方案，语法简洁、类型安全，底层适配Hibernate最新的API，兼容性和稳定性拉满，示例：

  // 推荐的Query DSL写法
  def results = Book.where {
      title == "Grails in Action" && author.lastName == "Brown"
  }.list()
  

• HQL查询：针对复杂关联、聚合查询场景，HQL依然是可靠选择，GORM通过executeQuery()支持，示例：

  def results = Book.executeQuery(
      "select b from Book b join b.author a where a.lastName = :lastName",
      [lastName: "Brown"]
  )
  

• 原生SQL：处理极端复杂的数据库特定查询时，可使用原生SQL，通过executeUpdate()或list()执行，注意做好数据库兼容性处理。

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