使用EntityManager执行原生查询时遭遇PersistenceException异常求助

问题场景 #

执行原生SQL查询账户明细时抛出异常：

javax.persistence.PersistenceException: org.hibernate.HibernateException: Could not extract result set metadata in select query

实现代码如下：

public List<Object> MerTxnDetailsReportCsv() {
    EntityManager entityManager = JPAUtility.getEntityManager();
    List<Object> auditList = null;
    try {
        Query query = entityManager.createNativeQuery(
                "select payee_account from txn_history_upi_fin WHERE TRUNC(trn_date_time,'DD') = TRUNC(SYSDATE-1, 'DD') and payee_account is not null group by payee_account");

        auditList = query.getResultList();
        logger.info(auditList);
    } catch (Exception e) {
        logger.error("Exception in MerTxnDetailsReportCsv : " + e);
        logger.error(e.getMessage(), e);
    } finally {
        try {
            if (null != entityManager)
                entityManager.close();
        } catch (Exception e1) {
            logger.error("Exception in MerTxnDetailsReportCsv : " + e1);
        }
    }
    return auditList;
}

原因分析 #

该异常核心是Hibernate无法正确解析原生SQL的结果集元数据，常见触发点：

• SQL语句存在语法错误（如函数参数错误、表/字段名拼写错误）
• 数据库驱动与Hibernate版本不兼容，导致元数据提取逻辑失效
• 未明确指定查询结果类型，Hibernate自动映射时出错

解决方案 #

1. 验证SQL合法性 #

直接在数据库客户端执行目标SQL，确认能正常返回结果。重点检查：

• trn_date_time字段是否为日期类型
• TRUNC函数的参数格式是否符合数据库规范（Oracle中TRUNC(date, 'DD')是合法写法）

2. 明确指定结果类型 #

由于查询仅返回单个字段payee_account，可以直接指定结果类型，绕过Hibernate的元数据自动解析：

// 根据payee_account实际类型调整，比如String、Long等
Query query = entityManager.createNativeQuery(sql, String.class);

3. 检查驱动与Hibernate版本兼容性 #

确保数据库驱动版本与项目使用的Hibernate版本匹配：

• 若使用Oracle数据库，推荐ojdbc8搭配Hibernate 5.x/6.x
• 若使用MySQL，推荐mysql-connector-java 8.0+搭配Hibernate 5.4+

4. 使用@SqlResultSetMapping（复杂场景） #

如果后续需要返回多字段或映射到实体类，可定义结果集映射：

// 在实体类或包级别添加映射定义
@SqlResultSetMapping(
    name = "PayeeAccountMapping",
    columns = @ColumnResult(name = "payee_account")
)

// 查询时指定映射名称
Query query = entityManager.createNativeQuery(sql, "PayeeAccountMapping");

5. 规范EntityManager生命周期 #

检查JPAUtility.getEntityManager()的实现，确保每次获取的都是有效、未关闭的EntityManager实例，避免因实例无效导致元数据提取失败。

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