PostgreSQL 15存储函数传递int2参数报错，求解决方法

问题场景 #

创建了如下PL/pgSQL存储函数：

CREATE OR REPLACE FUNCTION schema_name.function_name(
    in input_user_id int2
)
RETURNS TABLE(
    column_1 smallint,
    column_2 character varying,
    column_3 character varying,
    column_4 timestamp with time zone,
    column_5 timestamp with time zone,
    column_6 character varying,
    column_7 int2,
    column_8 int2
)
LANGUAGE plpgsql
AS $function$
begin
    return query
    select * 
    from schema_name.table_name
    where table_name.column_5 = input_user_id;
end;
$function$
;

直接执行select * from schema_name.table_name where column_5 = 1;能得到预期结果，但调用函数时出现两类错误：

错误1：参数类型不匹配 #

执行select * from schema_name.function_name(1);时报错：

SQL Error [42883]: ERROR: function schema_name.function_name(integer) does not exist
Hint: No function matches the given name and argument types. You might need to add explicit type casts.
Position: 15

错误2：返回结构不匹配 #

使用显式类型转换调用（如select * from schema_name.function_name(1::int2);）时，报错：

SQL Error [42804]: ERROR: structure of query does not match function result type
Detail: Returned type text does not match expected type smallint in column 7.
Where: SQL statement "select *
from schema_name.table_name
where table_name.column_5 = input_user_id"
PL/pgSQL function schema_name.function_name(smallint) line 3 at RETURN QUERY

问题原因及解决方法 #

针对错误1：参数类型不匹配 #

PostgreSQL对函数参数的类型匹配要求严格，直接输入1会被解析为integer类型，而函数定义的参数是int2（即smallint），不存在对应的隐式转换规则，因此必须显式转换参数类型。你尝试的1::int2、int2 '1'等方式是正确的，该错误的根源是后续的返回结构不匹配问题。

针对错误2：返回结构不匹配 #

报错明确指出，函数返回定义中column_7是smallint类型，但查询schema_name.table_name返回的对应列实际是text类型，类型不匹配导致报错。解决方式有两种：

1. 修改函数返回类型：将RETURNS TABLE中的column_7 int2改为与表中实际类型一致的text（或其他匹配类型）。
2. 转换查询结果类型：在函数的select语句中，显式将column_7转换为smallint类型，避免使用select *，改为指定列并转换：

select 
    column_1,
    column_2,
    column_3,
    column_4,
    column_5,
    column_6,
    column_7::smallint,  -- 显式转换类型
    column_8
from schema_name.table_name
where table_name.column_5 = input_user_id;

注意：如果column_7的text内容无法转换为smallint（比如包含非数字字符），这种转换会抛出新的错误，需要先确保数据可以安全转换。

另外需要额外检查：函数中where table_name.column_5 = input_user_id的条件逻辑是否合理——函数参数是input_user_id int2，但函数返回定义里table_name.column_5是timestamp with time zone类型，直接与int2类型参数比较可能存在字段名混淆或逻辑错误，建议确认表结构的实际字段类型。

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