PostgreSQL函数返回多行必须声明RETURNS SETOF或RETURNS TABLE，因RETURN仅支持单值或复合类型；若用RETURNS geometry等单值类型，即使SELECT多行也只取首行并静默截断，且未声明集合类型时RETURN QUERY会报错“function cannot return a set”或“query has no destination for result data”。
PostgreSQL 里没有“存储过程”，只有函数；返回结果集必须用 SETOF 或 RETURNS TABLE，不能用 RETURN geometry 这类单值语法直接返回多行。
为什么 RETURN 单值语句无法返回多行结果
PL/pgSQL 中的 RETURN 语句只支持返回一个值（标量）或一个复合类型（如 record），哪怕你写 RETURN QUERY SELECT ...，也必须提前声明函数返回类型为集合类型。否则会报错：ERROR: function cannot return a set 或 ERROR: query has no destination for result data。
-
RETURNS geometry只能返回单个几何对象，哪怕SELECT出 100 行，也只取第一行并静默截断 -
RETURN NEXT和RETURN QUERY是合法的集合返回方式，但前提是函数签名已声明为SETOF或TABLE - SQL 函数（
LANGUAGE sql）更简单：只要声明RETURNS SETOF some_table，函数体直接写SELECT就行，不用RETURN关键字
RETURNS TABLE 和 SETOF 的核心区别
两者都返回多行，但语义和约束不同：
-
RETURNS TABLE(col1 int, col2 text)：显式定义列名与类型，调用时无需AS别名，适合临时结构、无对应表的场景 -
RETURNS SETOF employee：复用已有表结构，字段名/类型/NOT NULL 约束全部继承，修改表结构后函数自动适配 -
RETURNS SETOF record：最灵活，但调用时必须用SELECT * FROM f() AS t(col1 int, col2 text)显式提供列定义，否则报ERROR: a column definition list is required - 性能上无差异；可读性和维护性上，优先用
SETOF existing_table，避免重复定义结构
常见错误：调用 SETOF record 时漏写 AS 列定义
比如函数定义为：
CREATE OR REPLACE FUNCTION f_dynamic() RETURNS SETOF record AS $$ BEGIN RETURN QUERY EXECUTE 'SELECT id, name FROM employee'; END; $$ LANGUAGE plpgsql;
直接执行 SELECT * FROM f_dynamic(); 会失败，因为 PostgreSQL 不知道返回的 record 具体长什么样。
- 正确调用方式：
SELECT * FROM f_dynamic() AS t(id int, name text); - 如果查询涉及 JOIN 或计算字段，
RETURNS TABLE更稳妥，例如：RETURNS TABLE(emp_id int, dept_name text, salary_ratio numeric) - 别依赖
%ROWTYPE在函数内声明变量来“推导”返回结构——它只影响内部变量，不改变函数签名
PostGIS 场景下返回几何结果集的推荐写法
不要用 RETURNS geometry 包裹多行几何；也不要让调用方自己猜字段。结合业务表结构最可靠：
- 有对应空间表（如
roads）：用RETURNS SETOF roads，直接RETURN QUERY SELECT * FROM roads WHERE ... - 需动态拼接字段（如加缓冲区距离）：用
RETURNS TABLE(geom geometry, buffer_dist numeric) - 避免
SETOF record+ 动态 SQL 组合——调试困难，且每次调用都得重写AS子句 - 若函数要被 GeoServer、QGIS 或 Hasura 消费，必须用明确列定义（
TABLE或具名SETOF），否则元数据无法识别
真正麻烦的不是语法，而是函数签名和调用端的列定义是否对齐；一旦用错 SETOF record 又忘了 AS，错误信息不会告诉你缺什么，只会卡在“列定义列表必需”这种模糊提示上。
