PAYATHON 2026

Hibernate Envers 添加 @Audited 后为何查询返回空列表?

数据小陈

结论

@Audited 的正常行为不会让普通 JPQL 查询转而查询审计表,业务记录也不需要先有审计历史才能被查到。你给出的 SQL 查询的仍是 A,目前没有证据表明问题出在 _AUD 表上。Envers 用于记录实体变更和查询历史版本,参见 Hibernate Envers 官方说明。

仅凭现有信息,无法确定唯一原因,也不能认定这是 Hibernate 6.2.46 的已知缺陷。可以先检查实际绑定的 key、数据库连接环境,以及执行查询时的事务状态。

先确认 SQL 中的问号实际绑定了什么

当前日志只显示:

where u1_0.BUSINESS_KEY=?

这里没有显示参数值和 JDBC 类型。手动执行 SQL 时,填入的值应与程序实际绑定的值一致,才能比较结果。如果按 id 可以查询、按 businessKey 返回空列表,应先核对这两个查询的输入。

Hibernate 6 可使用以下日志类别:

  • org.hibernate.SQL:设置为 DEBUG,查看 SQL。
  • org.hibernate.orm.jdbc.bind:设置为 TRACE,查看绑定参数。

这些类别可在 Hibernate 6.2 用户指南的日志配置说明中核对。

假设 key 是调用处已经取得的 long 值,查询代码可以明确写成:

List<A> rows = entityManager
    .createNamedQuery("queryA", A.class)
    .setParameter("key", key)
    .getResultList();

检查启用和移除 @Audited 时的绑定日志,确认 key 的值、类型及查询前的赋值流程一致。原始材料中没有 setParameter() 的调用代码,这是目前需要补充的信息。

在应用的连接环境中对比查询

数据库客户端能查到记录,只能说明该客户端会话可以看到数据。还要确认应用连接的数据库、用户和 schema 是否相同,数据可见性是否一致。

建议使用已提交的固定测试数据,在没有待写入变更的事务中,用同一个 EntityManager 分别执行 NamedQuery 和原生查询:

List<A> entities = entityManager
    .createNamedQuery("queryA", A.class)
    .setParameter("key", key)
    .getResultList();

List<?> databaseRows = entityManager
    .createNativeQuery(
        "SELECT ID, BUSINESS_KEY FROM A WHERE BUSINESS_KEY = ?1")
    .setParameter(1, key)
    .getResultList();

根据结果缩小范围:

  • 两者都为空:继续检查参数、连接目标和事务可见性。
  • 原生查询有结果,NamedQuery 为空:进一步检查完整实体映射、过滤器、查询选项及结果处理过程。
  • 两者都有结果:回到原业务调用路径,比较事务边界、输入值和执行顺序。

记录每次执行的 SQL 和绑定参数,避免比较不同条件下的结果。

区分按 ID 查找与条件查询

entityManager.find() 可能直接返回持久化上下文中已管理的实体,因此仅凭它查询成功,不能证明数据库条件查询正常。

你还提到,把查询条件改成 id 后也能返回结果。这比 find() 成功更有参考价值,但仍要确认按 ID 查询时是否实际发出了 SQL,以及返回行的 BUSINESS_KEY 是否等于传入的 key。

可以在新的 EntityManager 中,用已提交的数据重新执行两种查询,以减少已有实体状态的干扰。

检查查询前是否发生了写入或 flush

如果查询前调用过 persist()、修改过 businessKey 或执行过其他更新,还要查看查询前的 INSERT、UPDATE 和 DELETE。在 AUTO 模式下,Hibernate 可能在相关查询前执行 flush,具体行为见 Hibernate 6.2 用户指南。

确认有活动事务后,可以在诊断时显式调用:

entityManager.flush();

然后重新查询,检查完整日志。flush() 会把待处理变更同步到数据库,但不会提交事务。这个操作有助于定位执行顺序,原因未明时不应将它当作固定修复。

如果异常只在“同一事务内先写入、再查询”的路径出现,而独立查询已提交数据时正常,应重点检查事务边界、实体状态和相关监听器。

何时检查 Envers 依赖或提交缺陷报告

确认实际运行时的 hibernate-core 与 hibernate-envers 版本一致,并排查框架依赖管理是否引入了其他版本。

如果数据、参数、连接和事务条件固定后,最小示例仍然只在添加 @Audited 时返回空列表,就值得进一步调查 Hibernate 或 Envers 是否存在缺陷。复现材料至少应包含完整实体、数据准备步骤、参数绑定日志、事务代码,以及数据库和 JDBC 驱动版本。

下一步可以补充实际绑定参数,并在应用的连接环境中对比查询。移除 @Audited 后现象改变是一条排查线索,还不足以证明审计机制本身就是根因。

备注:内容仅供参考。