PostgreSQL 13.9函数返回类型自动转换未入文档？求确认

这并非PostgreSQL 13.9专属的新特性，而是PostgreSQL 13全系列引入的行为变更——从13版本开始，SQL函数的返回值类型检查逻辑被放宽，允许安全的隐式数值类型转换。

具体行为对比 #

PostgreSQL 12及更早版本 #

SQL函数的返回语句必须严格匹配声明的返回类型，否则直接抛出编译错误。例如你的测试函数：

CREATE FUNCTION test() RETURNS int
  AS $$ SELECT 1::bigint; $$
  LANGUAGE sql; 

会触发错误：

ERROR: return type mismatch in function declared to return record
Detail: Final statement returns bigint instead of integer at column 11.

PostgreSQL 13及以上版本（含13.9） #

当返回语句的结果类型与函数声明的返回类型属于可隐式转换的数值类型时，PostgreSQL会自动执行隐式转换，不再抛出编译错误。比如上述bigint转int的场景，数据库会自动将1::bigint转换为int类型返回。

文档相关说明 #

该特性属于SQL函数类型检查逻辑的优化，虽未在13版本的更新日志中单独高亮，但在官方文档的「SQL Functions」章节有相关描述：当函数返回类型与最终语句的类型可通过隐式转换兼容时，转换会自动完成。

注意事项 #

自动转换仅适用于安全的隐式转换场景：

• 若转换可能导致数据丢失（比如bigint数值超出int范围时），运行时会抛出numeric value out of range错误，而非编译阶段报错
• 非数值类型或不可隐式转换的类型（如text转int），仍然会触发编译错误

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