写 PostgreSQL 15 触发器时，很多问题并不出在条件判断，而是出在最后那句 RETURN。同样是触发器函数，行级 BEFORE、语句级 FOR EACH STATEMENT、视图上的 INSTEAD OF，返回值规则并不一样，写错后果也完全不同。
这篇文章按几类最常见的触发器场景来拆解：什么时候该 RETURN NEW，什么时候必须 RETURN NULL，哪些情况下漏写返回语句会静默丢数据，哪些情况下会直接报错。读完之后，你可以更快判断一个触发器是“没生效”，还是其实已经把当前行取消掉了。
`RETURN NEW` 和 `RETURN NULL` 到底差在哪
在行级 BEFORE 触发器中，返回值会直接影响当前这行数据是否继续执行原来的 INSERT 或 UPDATE。
RETURN NEW：表示使用当前的NEW记录继续执行写入。如果你已经修改过NEW，后续就会按修改后的值继续插入或更新。RETURN NULL：表示跳过当前行，这一行不会继续写入，后续触发器也不再执行。
这里最容易踩坑的是“漏写 RETURN”。在 PL/pgSQL 里，如果函数末尾没有显式返回值，行为上等同于返回 NULL。这类问题看起来像是触发器“没有生效”，但实际结果往往是当前行已经被静默丢弃。
为什么漏写返回语句尤其危险
因为这不是单纯的语法疏忽，而是会改变数据流向。你原本可能只想做字段清洗，结果却因为函数没有兜底 RETURN NEW，把满足或不满足条件的记录一起挡掉了。
如果触发器挂在核心写入链路上，这类问题通常比直接报错更难排查：SQL 语句本身可能执行成功，但目标表里就是少了一部分数据。
语句级触发器为什么必须显式 `RETURN NULL`
语句级触发器使用 FOR EACH STATEMENT，它不针对某一行执行，也不会访问 OLD 或 NEW。这类触发器更适合做全局动作，例如日志记录、计数、权限检查等。
在 PostgreSQL 15 中，这类触发器函数必须明确写出 RETURN NULL。如果函数执行到末尾却没有返回值，就会直接报错：
ERROR: control reached end of trigger procedure without returning a value这不是编码风格差异，而是语法要求。也正因为语句级触发器不参与单行数据的传递，所以它不应该返回 NEW 或 OLD，而是固定以 RETURN NULL 结束。
在 `INSERT` / `UPDATE` 前修改 `NEW` 的正确写法
如果你的目的不是阻止写入，而是在入库前统一字段格式，那么常见做法是在行级 BEFORE 触发器里修改 NEW，然后返回它。
例如对邮箱字段做去空格和转小写处理：
IF NEW.email IS NOT NULL THEN
NEW.email := lower(trim(NEW.email));
END IF;
RETURN NEW;这类写法适合哪些场景
典型用途包括：
- 自动补全空字符串或默认值
- 将输入统一为小写、去首尾空格
- 在写入前生成 UUID 或派生字段
写这类触发器时要盯住的 3 个点
- 必须使用
BEFORE触发时机，因为到了AFTER阶段，NEW已经不可变。 - 你修改的是
NEW这条记录本身，不是直接改原表字段。 - 即使某个判断分支没有命中，也要有兜底的
RETURN NEW，否则当前行仍然会被丢弃。
别忽略 `TRUNCATE` 和 `INSTEAD OF` 这两类特殊场景
TRUNCATE 触发器和普通行级触发器的思路不同，它只支持语句级的 BEFORE / AFTER 触发器，而且只能定义在普通表上。因此，它的触发器函数也必须采用语句级规则，以 RETURN NULL 结束。
另一个容易误判的是 INSTEAD OF 触发器。它只能定义在视图上，返回值逻辑更接近行级 BEFORE 触发器：
- 返回
NULL：取消这次操作 - 返回
NEW或OLD：表示由触发器接管并完成替代执行，具体取决于操作类型
一旦启用 INSTEAD OF 触发器，原本的 INSERT、UPDATE、DELETE 不会再按普通表那套流程落到表本身。也就是说，返回值不只是“收尾动作”，而是真正控制这次写操作是否成立的关键开关。
实际排查时怎么快速判断返回值写错了
如果你遇到以下现象，可以优先检查触发器函数最后的返回语句：
- 写入语句执行后没有明显报错，但部分记录没有落表
- 原本只想清洗字段，结果数据被整行跳过
- 语句级触发器创建或执行时报
control reached end of trigger procedure without returning a value - 视图上的写操作启用了
INSTEAD OF后，数据没有按预期进入底层表
简单归纳就是：行级 BEFORE 关注“这行还能不能继续”；语句级触发器关注“函数必须规范结束”；而 INSTEAD OF 则是在视图场景里直接接管原始操作。把这三类场景分清，返回值就不容易写错。
