Spring Data JPA调用PostgreSQL带uuid[]参数存储过程示例求助

这个问题我碰到过好多次了——你遇到的“函数不存在（参数为bytea）”异常，本质是Spring Data JPA默认把UUID数组转换成了PostgreSQL不认识的bytea类型，没正确映射到uuid[]。下面直接给你可行的实现步骤和代码示例：

1. 先确认PostgreSQL存储过程定义 #

首先得确保你的存储过程确实接收uuid[]类型参数，这里给一个示例存储过程：

CREATE OR REPLACE FUNCTION batch_get_users(user_ids uuid[])
RETURNS TABLE(id uuid, username varchar) AS $$
BEGIN
    RETURN QUERY SELECT id, username FROM users WHERE id = ANY(user_ids);
END;
$$ LANGUAGE plpgsql;

这个函数接收uuid数组，返回符合条件的用户记录。

2. 配置JPA的UUID数组类型映射 #

Spring Data JPA默认不支持PostgreSQL的uuid[]类型，需要告诉Hibernate如何正确映射它，这里给两种可行方式：

方式一：使用Hibernate内置类型（推荐） #

如果是Spring Boot + Hibernate项目，直接在Repository方法参数上指定org.hibernate.type.PostgresUUIDArrayType即可。先确保依赖包含Hibernate（Spring Boot默认已集成），然后定义Repository接口：

import org.hibernate.type.PostgresUUIDArrayType;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.query.Procedure;
import org.springframework.data.repository.query.Param;

import java.util.List;
import java.util.UUID;

public interface UserRepository extends JpaRepository<User, UUID> {

    @Procedure(procedureName = "batch_get_users")
    List<User> batchGetUsers(
        @Param("user_ids") UUID[] userIds,
        @org.hibernate.annotations.Parameter(name = "user_ids", type = PostgresUUIDArrayType.class)
    );
}

方式二：自定义类型映射（内置类型失效时用） #

如果上面的方式不生效，可以自定义类型映射类：

import org.hibernate.type.AbstractSingleColumnStandardBasicType;
import org.hibernate.type.descriptor.sql.UUIDArrayTypeDescriptor;
import org.hibernate.type.descriptor.java.UUIDArrayJavaTypeDescriptor;

public class CustomUUIDArrayType extends AbstractSingleColumnStandardBasicType<UUID[]> {
    public static final CustomUUIDArrayType INSTANCE = new CustomUUIDArrayType();

    public CustomUUIDArrayType() {
        super(UUIDArrayTypeDescriptor.INSTANCE, UUIDArrayJavaTypeDescriptor.INSTANCE);
    }

    @Override
    public String getName() {
        return "uuid-array";
    }
}

然后在application.properties里配置全局类型映射：

spring.jpa.properties.hibernate.type_contributors=com.yourpackage.CustomUUIDArrayTypeContributor

（对应的TypeContributor需要实现Hibernate的TypeContributor接口，注册自定义类型）

3. 调用存储过程的两种实践方式 #

方式一：通过Spring Data Repository调用 #

注入Repository后直接调用方法：

@Service
public class UserService {
    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public List<User> getUsersByIds(List<UUID> userIds) {
        UUID[] idsArray = userIds.toArray(new UUID[0]);
        return userRepository.batchGetUsers(idsArray);
    }
}

方式二：通过EntityManager手动调用 #

如果注解方式有问题，也可以用EntityManager直接执行：

import jakarta.persistence.EntityManager;
import jakarta.persistence.StoredProcedureQuery;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.UUID;

@Service
public class UserService {
    private final EntityManager entityManager;

    public UserService(EntityManager entityManager) {
        this.entityManager = entityManager;
    }

    public List<User> getUsersByIds(List<UUID> userIds) {
        StoredProcedureQuery query = entityManager.createStoredProcedureQuery("batch_get_users", User.class);
        query.registerStoredProcedureParameter("user_ids", UUID[].class, jakarta.persistence.ParameterMode.IN);
        // 关键：指定Hibernate类型为PostgresUUIDArrayType
        query.setParameter("user_ids", userIds.toArray(new UUID[0]), org.hibernate.type.PostgresUUIDArrayType.INSTANCE);
        
        return query.getResultList();
    }
}

4. 避坑提醒 #

• 必须传递UUID[]数组，不能直接用List<UUID>，否则JPA无法正确识别为PostgreSQL的uuid[]类型。
• 确保存储过程的参数名称和代码中@Param指定的名称一致（PostgreSQL大小写不敏感，但统一命名更稳妥）。
• 旧版Hibernate可能需要额外依赖，比如Maven引入：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.19.0</version>
</dependency>

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