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

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

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

## 速览 {#at-a-glance}

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

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| 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` |
| 别名 | `—` |

<!-- source facts: data/errcodes/25P02.json -->
<!-- END SQLSTATE FACTS -->

## 含义 {#meaning}

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

## 诊断 {#diagnosis}

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

## 处理 {#response}

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

## 源码报文 {#messages}

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

## 实测诊断 {#observed}

`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']]`。

## 代表案例 {#case}

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

<!-- BEGIN SQLSTATE SNIPPET: failed_transaction -->
```sql
-- 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;
```
<!-- END SQLSTATE SNIPPET -->

上述片段的 SQLSTATE、诊断、状态和修复断言来自共享语句清单（registry）（SHA-256 `04da3240dcf3c03fe60d13715f8187350fadf5b8d1f10e5b837acd45289759cd`）；[结构化证据](../../data/evidence/25p02.json)。

作者证据 ID：`identity`, `abort-state`, `runtime`。选定运行记录：`runtime.25P02-batch2-latest-20260909.latest`, `runtime.25P02-batch2-pg10-20260909.pg10`。
## 版本与边界 {#versions}

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

## 相关 {#related}

[23505 唯一约束冲突](../23505/)、[25P01 没有活动 SQL 事务](../25p01/)、[40001 可串行化失败](../40001/)。

## 来源 {#sources}

- [`src.errcodes.18.6`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt) (SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba`)
- `src.calls.REL_18_6` — `raw/calls/REL_18_6.jsonl` (SHA-256 `9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf`)
- [`src.postgres.18.6`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/tcop/postgres.c#L1127-L1140) (SHA-256 `9fb62275b1badf94d01ab351337b60410cd9b3ab1fe63fa9f23d6d2185a21061`)
- [`doc.libpq.18.6`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/doc/src/sgml/libpq.sgml#L2818-L2835) (SHA-256 `a91ce8f29dde162245d2f35f839e8b7192f62a57e01020b80564af65edd09440`) · [official documentation](https://www.postgresql.org/docs/18/libpq-status.html)