跳转到主要内容

25P02 — 事务处于失败状态（in_failed_sql_transaction）

PostgreSQL SQLSTATE 25P02：前一条语句失败后出现的次级事务状态。

25P02 — 事务处于失败状态（in_failed_sql_transaction）

速览

25P02 通常是第二个诊断，而不是根因。选定案例先因重复键返回 23505，随后 SELECT 在事务仍为 INERROR 时被 25P02 拒绝；必须先 ROLLBACK 才能有效重试。

字段 值
SQLSTATE 25P02
条件名 in_failed_sql_transaction
状态 有效
已知存在于 7.4
锁定快照 9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3
宏 ERRCODE_IN_FAILED_SQL_TRANSACTION
别名 —

含义

postgres.c 在再次规划普通命令前检查已中止事务状态，并报告 current transaction is aborted, commands ignored until end of transaction block。驱动会暴露对应的失败事务状态；原始错误仍是诊断锚点，25P02 表示该事务块已经不能继续执行普通业务语句。

诊断

先定位 25P02 之前的第一条语句错误，再记录两个诊断和连接事务状态。选定运行显示根错误 23505、随后 25P02；两次之后都为 INERROR，ROLLBACK 后为 IDLE，新的显式 BEGIN/COMMIT 成功提交有效行。检查根错误前是否建立了保存点：ROLLBACK TO SAVEPOINT 可以保留外层事务；没有保存点时必须结束整个失败事务块。连接池不能把 INERROR 会话交给下一个请求。

处理

第一条错误后停止发送业务语句，保留根 SQLSTATE 和详情。若事先建立的保存点仍可用，就回滚到该保存点并继续外层事务；否则执行 ROLLBACK，确认连接回到 IDLE，再开启新事务。应重新评估操作，不要盲目重放根语句。

源码报文

固定主报文是 current transaction is aborted, commands ignored until end of transaction block。它描述前一条错误留下的事务状态，不能覆盖根错误的 SQLSTATE、DETAIL 或约束身份。

实测诊断

18.6 (Homebrew) / latest：根 SQLSTATE 23505；次级 SQLSTATE 25P02；根错误/次级诊断后均为 INERROR；回滚后 IDLE；行集 [[1, 'seed'], [2, 'repaired']]。 10.21 (Debian 10.21-1.pgdg90+1) / pg10：根 SQLSTATE 23505；次级 SQLSTATE 25P02；根错误/次级诊断后均为 INERROR；回滚后 IDLE；行集 [[1, 'seed'], [2, 'repaired']]。

代表案例

运行器从共享语句清单（registry）读取下列根错误、次级诊断、回滚和有效重试语句；完整断言、环境和清理见 案例导出。

-- create
CREATE TABLE items(id integer PRIMARY KEY, note text UNIQUE NOT NULL);
-- seed
INSERT INTO items VALUES (1, 'seed');
-- begin
BEGIN;
-- trigger
INSERT INTO items VALUES (2, 'seed');
-- followup
SELECT 1 AS ignored;
-- rollback
ROLLBACK;
-- repair_begin
BEGIN;
-- repair
INSERT INTO items VALUES (2, 'repaired');
-- commit
COMMIT;
-- verify
SELECT id, note FROM items ORDER BY id;

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

作者证据 ID：identity, abort-state, runtime。选定运行记录：runtime.25P02-batch2-latest-20260909.latest, runtime.25P02-batch2-pg10-20260909.pg10。

版本与边界

选定的“重复键后出现 25P02”案例在 PostgreSQL 18.6 与 10.21 通过。它证明事务状态恢复，不表示可以原样重试重复键操作。

23505 唯一约束冲突、25P01 没有活动 SQL 事务、40001 可串行化失败。

来源

  • src.errcodes.18.6 (SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba)
  • src.calls.REL_18_6 — raw/calls/REL_18_6.jsonl (SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf)
  • src.postgres.18.6 (SHA-256 9fb62275b1badf94d01ab351337b60410cd9b3ab1fe63fa9f23d6d2185a21061)
  • doc.libpq.18.6 (SHA-256 a91ce8f29dde162245d2f35f839e8b7192f62a57e01020b80564af65edd09440) · official documentation