JPA/Hibernate调用PostgreSQL数组存储过程报函数不存在错误求助

这个问题我之前也碰到过，核心原因是Hibernate默认没有把Java的int[]（基本类型数组）正确映射到PostgreSQL的integer[]类型，反而把它序列化成了bytea二进制类型，导致PostgreSQL找不到匹配的存储过程，才会抛出function fn_test_array(bytea) does not exist的错误。

下面给你几个可行的解决方案，按推荐程度排序：

方案1：使用JDBC Array对象传递参数 #

这是最直接且不需要额外依赖的方法，利用JDBC原生的Array类型来构造PostgreSQL识别的整数数组：

// 从EntityManager获取JDBC连接
Connection conn = em.unwrap(Connection.class);
// 创建PostgreSQL兼容的integer类型数组
Array sqlArray = conn.createArrayOf("integer", new Integer[]{1, 2});

StoredProcedureQuery query2 = em.createStoredProcedureQuery("fn_test_array")
    .registerStoredProcedureParameter("in_arr", Array.class, ParameterMode.IN)
    .registerStoredProcedureParameter("res_int", Long.class, ParameterMode.OUT)
    .setParameter("in_arr", sqlArray);

query2.execute();
Long res2 = (Long) query2.getOutputParameterValue("res_int");
System.out.println("res2: " + res2);

// 记得手动释放Array资源，避免连接泄漏
sqlArray.free();

方案2：使用Hibernate自定义类型（推荐，代码更简洁） #

如果你的项目可以引入第三方依赖，推荐使用Vlad Mihalcea的hibernate-types库，它专门解决Hibernate和各种数据库的类型映射问题：

第一步：添加依赖（Maven为例） #

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.19.0</version> <!-- 版本对应你的Hibernate版本，比如Hibernate 5用52，Hibernate 6用60 -->
</dependency>

第二步：修改调用代码 #

注意这里要用Integer[]（包装类型数组）代替int[]，配合自定义类型完成映射：

StoredProcedureQuery query2 = em.createStoredProcedureQuery("fn_test_array")
    .registerStoredProcedureParameter("in_arr", Integer[].class, ParameterMode.IN)
    .registerStoredProcedureParameter("res_int", Long.class, ParameterMode.OUT)
    .setParameter("in_arr", new Integer[]{1, 2}, PostgresIntegerArrayType.INSTANCE);

query2.execute();
Long res2 = (Long) query2.getOutputParameterValue("res_int");
System.out.println("res2: " + res2);

方案3：使用原生SQL调用 #

如果不想折腾JPA的存储过程API，直接用原生SQL调用也是一种选择：

// 使用原生SQL调用存储过程
Query query = em.createNativeQuery("SELECT fn_test_array(?1)");
// 同样可以用JDBC Array或者自定义类型传递参数
query.setParameter(1, new Integer[]{1, 2}, PostgresIntegerArrayType.INSTANCE);

Long res2 = (Long) query.getSingleResult();
System.out.println("res2: " + res2);

关键注意点 #

• 尽量用Integer[]代替int[]：Hibernate对包装类型数组的支持比基本类型数组更友好，不容易出现类型映射错误。
• 资源释放：如果使用JDBC Array对象，一定要记得调用free()方法释放资源，避免数据库连接泄漏。

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