# 25008 — 持有游标要求相同隔离级别（held_cursor_requires_same_isolation_level）

> PostgreSQL SQLSTATE 25008：持有游标要求相同隔离级别的源码边界与诊断参考。
---

# 25008 — 持有游标要求相同隔离级别（held_cursor_requires_same_isolation_level）

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

`25008` 用于持有游标与操作要求的事务隔离级别不兼容的情况。固定 PostgreSQL 18.6 核心扫描没有该码的直接报错组。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `25008` |
| 条件名 | `held_cursor_requires_same_isolation_level` |
| 状态 | `有效` |
| 已知存在于 | `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_HELD_CURSOR_REQUIRES_SAME_ISOLATION_LEVEL` |
| 别名 | `—` |

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

## 含义 {#meaning}

它比 `24000` 游标状态无效更窄，也不是一般的 `40001` 可串行化重试路径。游标跨事务持有本身不能证明服务器发出了 25008。

## 诊断 {#diagnosis}

应记录游标声明、holdability、两个事务的隔离级别以及实际报出的精确 SQLSTATE。当前固定证据没有报文模板或可复制 SQL 触发器。

## 处理 {#response}

让持有游标和使用它的事务保持兼容隔离级别，或按 API 契约关闭并重新声明。没有实际状态证据时，不要套用 24000 修复或通用回滚。

## 源码报文与运行边界 {#messages}

固定 `errcodes.txt` 定义了该条件和宏；`raw/calls/REL_18_6.jsonl` 的解析调用扫描没有直接报错组，因此本批不发布报文模板，也不构造自然 SQL 触发器。

## 适用边界与案例 {#case}

本批运行器在 PostgreSQL 18.6 与 10.21 的选定 case 均为 `not_applicable`，只记录源码边界，没有可复制的 SQL 触发过程。[结构化证据](../../data/evidence/25008.json) · [案例导出](../../data/cases/25008.json)

## 版本与边界 {#versions}

生成事实记录锁定目录成员。选定的 latest 与 PG10 case 有意保持仅源码和 `not_applicable` 状态。

## 相关 {#related}

[24000 游标状态无效](../24000/)、[25004 分支事务隔离级别](../25004/)、[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`)