Spring Boot调用PostgreSQL存储过程报“Procedure does not exist”及“需显式类型转换”错误的解决咨询

我完全懂你现在的困扰——明明PostgreSQL的存储过程已经创建好了，用函数的方式能正常拿到结果，换成Spring Boot的@Procedure注解调用就一直报存储过程不存在，还提示要显式类型转换，这问题确实容易踩坑，我来帮你拆解一下问题出在哪，以及怎么调整。

首先，咱们先把你的问题点逐一梳理清楚：

1. 参数映射不匹配是核心问题之一 #

你的存储过程定义里，IN参数的名字是nuseridparam，但你在Repository方法里用的@Param("nuserid")，参数名字完全对不上！Spring Data JPA在映射存储过程参数的时候，会严格按照参数名去匹配，名字不匹配就会导致生成的调用语句参数数量/名称不对，数据库自然找不到对应的存储过程签名，就会报“procedure does not exist”的错误。

2. 返回类型与存储过程的输出逻辑不匹配 #

你的存储过程是用SELECT ... INTO把单个用户的ID和用户名放到两个OUT参数里，它并不是返回一个结果集，但你在Repository方法里定义的返回类型是List<Users>，这完全不符合当前存储过程的输出逻辑，这也是Spring无法正确映射的原因之一。

3. @Procedure对PostgreSQL存储过程的映射细节 #

PostgreSQL的存储过程调用语法和函数不同，用的是CALL语句，而@Procedure的自动映射有时候对带OUT参数的存储过程支持不够顺滑，咱们可以分两种情况来调整：

方案一：适配当前的OUT参数型存储过程

如果你想继续用现在的存储过程，需要修改Repository方法，让它正确匹配存储过程的OUT参数，同时调整返回逻辑：

// 注意参数名要和存储过程的IN参数完全一致
@Procedure(procedureName = "spgetusers1")
void spgetusers1(@Param("nuseridparam") Integer nuseridparam,
                 @Param("nuserid") Out<Integer> nuserid,
                 @Param("susername") Out<String> susername);

调用这个方法的时候，你需要创建Out类型的参数来接收返回值，然后再把这些值组装成Users对象：

// 示例调用代码
Out<Integer> userIdOut = new Out<>(Integer.class);
Out<String> usernameOut = new Out<>(String.class);
userRepository.spgetusers1(1, userIdOut, usernameOut);
Users user = new Users(userIdOut.getValue(), usernameOut.getValue());

方案二：修改存储过程为返回结果集（更贴合你要返回List的需求）

如果你期望存储过程返回用户列表（哪怕当前是单个结果），可以修改存储过程用游标返回结果集，这样更符合Spring Data JPA的结果映射逻辑：

CREATE OR REPLACE PROCEDURE spgetusers1(nuseridparam integer, ref refcursor)
LANGUAGE 'plpgsql'
AS $BODY$
BEGIN
    -- 打开游标返回查询结果
    OPEN ref FOR SELECT u.nuser_id AS nuserid, u.nuser_name AS susername FROM users u WHERE u.nuser_id = nuseridparam;
END;
$BODY$;

然后在Repository里用@Query配合原生SQL调用（这种方式比@Procedure更直观可控）：

@Query(value = "CALL spgetusers1(:nuseridparam, ?)", nativeQuery = true)
List<Users> spgetusers1(@Param("nuseridparam") Integer nuseridparam, RefCursor refCursor);

或者用构造函数投影来自动映射结果（如果你的Users类有对应的构造函数），这样就能直接拿到List<Users>类型的结果了。

最后再提几个注意点 #

• 确保你的Users实体类的字段名和存储过程返回的列名完全匹配（或者用@Column注解映射）
• 调用存储过程时，PostgreSQL的用户需要有执行该存储过程的权限
• 如果你还是想用@Procedure注解，一定要保证@Param的名字和存储过程的参数名（包括IN/OUT）完全一致，Spring会自动识别参数方向

内容来源于stack exchange