Java中如何将CriteriaQueryImp对象转为字符串打印输出

直接用ObjectMapper序列化org.hibernate.query.criteria.internal.Criteria实例触发报错是必然结果：该类是Hibernate运行时的内部实现类，内部持有大量不可序列化的运行时上下文引用，包括Session关联、持久化类代理、循环嵌套的关联路径对象、未初始化的延迟加载元数据，既无默认序列化构造，也存在大量循环引用，完全不适合直接做JSON序列化。

所有方案都不需要强行序列化Hibernate内部Criteria对象，从日志记录的实际需求出发选即可：

• 优先使用Hibernate原生API直接输出生成的查询语句，零侵入无兼容问题
  构造完Criteria查询后，将其转换为Hibernate的Query实例，直接提取生成的JPQL和最终SQL字符串打日志，拿到的内容可读性远高于序列化后的复杂对象结构，完全满足日志留痕需求：

  // 构造完CriteriaQuery之后的处理逻辑
  TypedQuery<YourEntity> typedQuery = entityManager.createQuery(criteriaQuery);
  org.hibernate.query.Query<?> hibernateQuery = typedQuery.unwrap(org.hibernate.query.Query.class);
  
  // 提取JPQL语句
  String jpql = hibernateQuery.getQueryString();
  // 提取最终生成的SQL（带参数占位符）
  String executeSql = hibernateQuery.getQueryPlan().getSqlString();
  
  log.info("Criteria生成查询, JPQL: {}, 执行SQL: {}", jpql, executeSql);
  

• 如果需要结构化的Criteria内容日志，自定义POJO提取必要字段后再序列化
  不要直接把Hibernate内部对象传给ObjectMapper，可根据日志需要的信息维度，自定义一个无复杂引用的普通POJO，手动从Criteria实例中提取目标实体、查询条件、排序规则、分页参数等必要字段填充到POJO中，再序列化这个自定义POJO即可，不会触发任何序列化错误，也不会因为Hibernate版本升级出现兼容问题。
  示例POJO结构：

  // 纯日志用简单对象，无外部依赖引用
  @Data
  public class CriteriaLogDTO {
      private String queryTargetClass;
      private List<String> whereConditions;
      private List<String> sortRules;
      private Integer pageSize;
      private Integer pageOffset;
  }
  

• 如果需要全量查询日志，配置全局SQL拦截统一打印，无需单独处理Criteria
  要是日志需求是记录所有DAO层执行的查询，完全不需要在每个Criteria构造逻辑里加打印代码，直接配置Hibernate的语句拦截器，统一拦截所有最终生成执行的SQL即可，不管是Criteria、JPQL还是原生SQL查询都能覆盖：

  # SpringBoot配置示例
  spring:
    jpa:
      properties:
        hibernate:
          format_sql: true
          session_factory:
            statement_inspector: com.yourapp.log.SqlPrintInterceptor
  

  自定义SqlPrintInterceptor实现org.hibernate.resource.jdbc.spi.StatementInspector接口，在拦截方法里打印完整SQL即可。

不要尝试通过给Hibernate内部类写Jackson Mixin序列化规则、关闭Jackson循环引用检测的方式直接序列化Criteria实例：Hibernate内部类结构随版本迭代变动极大，维护成本极高，且序列化过程中可能意外触发关联属性的懒加载，引发意料之外的数据库查询，拖慢业务性能。

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