39P01

速览

39P01 是 trigger_protocol_violated。固定源码确认它同时出现在核心 trigger manager、contrib/tcn 以及 PL/Perl trigger 返回值检查中，消息和严重级别取决于具体路径。

含义

这是 trigger 调用契约不成立：核心管理器可能报告 trigger function %u returned null value 或 BEFORE STATEMENT trigger cannot return a value；tcn 函数在错误的 timing/level/参数条件下被调用，或表没有主键；PL/Perl DELETE trigger 的修改可能被 WARNING 忽略，非法返回值则是 ERROR。

诊断

先按 message 区分来源：核心管理器检查 isnull 标志和 BEFORE STATEMENT 返回契约；tcn 要核对 AFTER、FOR EACH ROW、参数个数和主键；PL/Perl 要核对返回是否为 undef、SKIP 或 MODIFY。DELETE 修改被忽略的报文是 WARNING，非法返回报文是 ERROR；不要把所有 39P01 都归为同一个 trigger 类型。

处置

修正 trigger 的 timing、level、事件、参数和返回值契约；对 tcn 还要核对表主键和调用顺序。PL/Perl 的 WARNING 表示 DELETE 行修改被忽略，非法返回值则使调用失败；先确认原操作是否完成和业务是否接受该结果，再决定后续写入。修复契约后才重新执行。

版本

锁定目录从 7.4 记录该条件，并在正式快照及 19beta3 中出现；源码路径取 PostgreSQL 18.6。

相关条件

39P02, 39P03, 2F005

来源

可直接阅读固定的 trigger.c、tcn.c 和 plperl.c 路径；完整范围见结构化证据记录。