25P01 no_active_sql_transaction

速览

25P01 表示操作需要活动 SQL 事务。选定案例在自动提交会话中发送 SAVEPOINT，得到精确错误且会话保持 IDLE；随后在 BEGIN 内重新执行并提交。

含义

源码把语句名填入 %s can only be used in transaction blocks；本文的 SAVEPOINT 路径严重级别为 ERROR。同一 SQLSTATE 还覆盖 COMMIT AND CHAIN/ROLLBACK AND CHAIN 的错误，以及无事务时 COMMIT/ROLLBACK 的警告，固定报文是 there is no transaction in progress。

诊断

执行 SAVEPOINT、RELEASE SAVEPOINT 或 ROLLBACK TO SAVEPOINT 前，先确认客户端已进入显式事务块。选定运行中失败的自动提交语句后仍为 IDLE；修复序列是 BEGIN、SAVEPOINT、RELEASE、COMMIT。

处理

创建保存点前先启动显式事务。若操作误发在事务块外，应修正客户端事务包装后重试；本自动提交错误没有遗留失败事务块，因此不需要回滚。

源码报文

xact.c 用 %s can only be used in transaction blocks 组装语句级报文；本案例把 %s 替换为 SAVEPOINT，严重级别为 ERROR。COMMIT AND CHAIN 与 ROLLBACK AND CHAIN 在无事务块时使用同一动态形式；无事务时的 COMMIT/ROLLBACK 则使用 WARNING 报文 there is no transaction in progress。

实测诊断

18.6 (Homebrew) / latest：SQLSTATE 25P01；主报文 SAVEPOINT can only be used in transaction blocks；错误后状态 IDLE；显式事务修复 INTRANS → IDLE。 10.21 (Debian 10.21-1.pgdg90+1) / pg10：SQLSTATE 25P01；主报文 SAVEPOINT can only be used in transaction blocks；错误后状态 IDLE；显式事务修复 INTRANS → IDLE。

代表案例

运行器从共享语句清单（registry）读取下列无事务保存点和显式块修复语句；完整断言、环境和清理见 案例导出。

-- trigger
SAVEPOINT outside_block;
-- begin
BEGIN;
-- savepoint
SAVEPOINT inside_block;
-- release
RELEASE SAVEPOINT inside_block;
-- commit
COMMIT;
-- verify
SELECT 1;

上述片段的 SQLSTATE、诊断、状态和修复断言来自共享语句清单（registry）（SHA-256 a1ffffc778f82789f1c1ac4027a109fc76e4b315ef2e3a5bdbfc47c8f84ce951）；结构化证据。

作者证据 ID：identity, savepoint-path, runtime。选定运行记录：runtime.25P01-batch2-latest-20260909.latest, runtime.25P01-batch2-pg10-20260909.pg10。

版本与边界

SAVEPOINT 案例在 18.6 与 10.21 返回相同主报文的 25P01，显式事务块修复后两个目标均回到 IDLE。

相关

25005 分支事务没有活动 SQL 事务、25P02 失败 SQL 事务、25006 只读 SQL 事务。

来源

• 上游源码 doc/src/sgml/ref/savepoint.sgml 第 68–78 行 REL_18_6 724edf9bd aa6e167d
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/access/transam/xact.c 第 3724–3749 行 REL_18_6 724edf9bd 75b012c0
• 上游源码 src/backend/access/transam/xact.c 第 4418–4424 行 REL_18_6 724edf9bd 75b012c0
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8