如何在SpringBoot中向PostgreSQL函数传递数字列表？

问题原因 #

当传入非空List<Long>时，Spring Data JPA未将其正确转换为PostgreSQL的bigint[]类型，反而拆解为多个独立的bigint参数，导致PostgreSQL找不到匹配参数类型的函数。空列表能正常执行是因为PostgreSQL对空数组的兼容处理。

解决方案 #

方法1：SQL中显式转换参数类型 #

修改查询语句，通过CAST将参数转换为bigint[]类型：

@Query(nativeQuery = true, value = "SELECT 'OK' from delete_organization_info(:orgId, CAST(:orgInfoIds AS bigint[]), :orgInfoType)")
String deleteOrganizationInfoUsingDatabaseFunc(@Param("orgId") Long orgId,
                                               @Param("orgInfoIds") List<Long> orgInfoIds,
                                               @Param("orgInfoType") String orgInfoType);

也可使用PostgreSQL的array构造函数实现转换：

@Query(nativeQuery = true, value = "SELECT 'OK' from delete_organization_info(:orgId, array[:orgInfoIds], :orgInfoType)")
String deleteOrganizationInfoUsingDatabaseFunc(@Param("orgId") Long orgId,
                                               @Param("orgInfoIds") List<Long> orgInfoIds,
                                               @Param("orgInfoType") String orgInfoType);

方法2：使用@ArrayTypeHint注解（Spring Data JPA 2.2+适用） #

在参数上添加@ArrayTypeHint注解，指定数组元素类型，让Spring自动完成类型映射：

import org.springframework.data.jpa.repository.query.ArrayTypeHint;

@Query(nativeQuery = true, value = "SELECT 'OK' from delete_organization_info(:orgId, :orgInfoIds, :orgInfoType)")
String deleteOrganizationInfoUsingDatabaseFunc(@Param("orgId") Long orgId,
                                               @Param("orgInfoIds") @ArrayTypeHint(Long.class) List<Long> orgInfoIds,
                                               @Param("orgInfoType") String orgInfoType);

方法3：改用数组类型传递参数 #

将Repository方法的参数类型从List<Long>改为Long[]，Spring会自动映射为PostgreSQL的bigint[]：

@Query(nativeQuery = true, value = "SELECT 'OK' from delete_organization_info(:orgId, :orgInfoIds, :orgInfoType)")
String deleteOrganizationInfoUsingDatabaseFunc(@Param("orgId") Long orgId,
                                               @Param("orgInfoIds") Long[] orgInfoIds,
                                               @Param("orgInfoType") String orgInfoType);

调用时只需将List转换为数组，例如orgInfoIds.toArray(new Long[0])。

内容的提问来源于stack exchange，提问作者Leonardo Mora López