PostgreSQL的触发器功能依赖一套严格的内部调用约定，触发器函数并非普通意义上的存储函数，它由触发器管理器在INSERT、UPDATE、DELETE等事件发生时统一调度。理解返回类型的强制约束，是写出稳定触发器逻辑的前提。
一、触发器管理器的调用契约
当我们在表中创建触发器并关联一个PL/pgSQL函数时，实际上是在告诉PostgreSQL内核：在特定的行操作前后，请调用这个函数并交由其决定如何处理当前行。触发器管理器并不会像调用普通SQL函数那样直接取函数的标量返回值，而是期望函数返回一个指向TriggerData结构的记录指针，该指针在系统内部被识别为TRIGGER类型（旧版本中也允许opaque）。
这种机制的设计原因在于，触发器函数需要访问TG_OP、TG_TABLE_NAME、TG_WHEN等上下文变量，同时也要通过返回值告知内核是否继续该行的写操作、是否替换行内容。如果返回类型不是TRIGGER，执行器在获取函数结果时就无法将其映射到触发器上下文，于是抛出类型不匹配的错误。下面的代码展示了一个正确声明返回类型的函数框架。
CREATE OR REPLACE FUNCTION log_user_update() RETURNS TRIGGER AS $$ BEGIN -- 在更新前后将变动写入日志表 INSERT INTO user_log(user_id, old_name, new_name) VALUES (NEW.id, OLD.name, NEW.name); -- 返回修改后的新行，使更新继续 RETURN NEW; END; $$ LANGUAGE plpgsql;
二、返回值在行级流程中的传递路径
对于行级触发器（FOR EACH ROW），RETURN NEW、RETURN OLD或RETURN NULL具有不同的语义。RETURN NEW表示以函数内部可能修改后的新行继续写操作；RETURN OLD在更新或删除时可用于特定拦截；RETURN NULL则直接中止当前行的操作，不再执行后续触发器或落盘。这些值之所以能生效，正是因为函数返回的是TRIGGER类型记录，内核可从中提取行指针并替换执行计划中的目标元组。
假如将函数声明为返回void或integer，即便函数体里写了RETURN NEW，PL/pgSQL在编译期虽不报错，但运行期触发器管理器接收到的是非触发器记录指针，系统无法解析其中包含的行数据，于是中断事务并报错。我们可以通过对比表来看不同返回类型在触发器场景下的表现差异。
| 函数返回类型 | 能否用于触发器 | 典型错误 |
|---|---|---|
| TRIGGER | 可以 | 无 |
| opaque（旧版） | 可以（兼容） | 新项目不推荐 |
| void或integer | 不可以 | return type mismatch |
三、常见声明误区与调试方式
很多人在迁移其他数据库逻辑时，会习惯把函数写成返回整数表示成功或失败，例如RETURNS integer然后在触发器里返回1。在PostgreSQL中这必然失败，因为触发器不是靠数字状态码控制流程的。正确的做法是保持RETURNS TRIGGER，在函数内用RETURN NULL或RETURN NEW来表达控制意图，而不是用数字。
调试时，若遇到“function return type must be trigger or opaque”的提示，首先应检查CREATE FUNCTION里的RETURNS子句。此外，使用RAISE NOTICE打印TG_OP等变量，可以确认函数确实运行在触发器上下文中。以下示例演示了如何在函数开头做上下文保护，避免被误当作普通函数调用。
CREATE OR REPLACE FUNCTION guard_demo()
RETURNS TRIGGER AS $$
BEGIN
-- 若不在触发器上下文，TG_OP为空
IF TG_OP IS NULL THEN
RAISE EXCEPTION '该函数只能作为触发器使用';
END IF;
RAISE NOTICE '当前操作是 %', TG_OP;
RETURN NEW;
END;
$$ LANGUAGE plpgsql;
四、语句级触发器的返回要求
对于语句级触发器（FOR EACH STATEMENT），虽然没有OLD和NEW行可供返回，但函数依然必须声明为RETURNS TRIGGER。此时返回值通常被忽略，一般写RETURN NULL即可，但类型约束不变。系统仍按触发器协议调用函数，若类型不对，语句执行前就会报错，不会进入函数体逻辑。
这也说明返回类型的限制不是针对“行数据”本身，而是针对“调用协议”。无论行级还是语句级，PostgreSQL统一用TRIGGER类型来标识这类特殊函数，从而和普通的SQL callable function区分开，保证执行器的调度路径清晰且安全。
五、总结与实践建议
在编写PL/pgSQL触发器函数时，始终将返回类型固定为TRIGGER，并通过RETURN NEW、RETURN OLD或RETURN NULL来表达行控制逻辑。不要用普通函数返回值思维去设计触发器，也不要试图用自定义类型或标量类型绕过限制。遵循协议不仅能避免运行期错误，也让触发器逻辑更易被团队理解和维护。
建议在项目中统一触发器函数命名后缀如_trg，并在代码评审时重点检查RETURNS子句。这样能从源头杜绝类型声明错误，让数据库约束真正服务于业务数据的完整性与可追溯性。
PostgreSQL触发器PL/pgSQL修改时间：2026-08-05 09:27:37