08000 — 连接异常

速览 {#at-a-glance}

SQLSTATE 08000 是 Class 08 中的 connection_exception。连接异常是一个宽泛的连接管理条件。固定 PostgreSQL 路径中，postgres_fdw 会在中止清理失败、外部服务器连接不可再用时使用它；单纯的客户端拒绝连接不足以证明此码。

含义 {#meaning}

连接异常是一个宽泛的连接管理条件。固定 PostgreSQL 路径中，postgres_fdw 会在中止清理失败、外部服务器连接不可再用时使用它；单纯的客户端拒绝连接不足以证明此码。

诊断 {#diagnosis}

检查服务器日志、外部服务器名、后端 PID、事务结果和 FDW 清理路径。将报文与 08001（无法建立连接）和 08006（已有连接失败）区分；客户端库可能返回另一种异常，甚至没有 SQLSTATE。

处理 {#response}

修复外部连接或清理条件，按具体路径结束失败事务；只有确认远端结果后，才重试完整且安全的业务单元。不要把普通网络异常改标为 08000。

报文 {#messages}

固定的 postgres_fdw 分支以 ERROR 发出主报文 connection to server "%s" cannot be used due to abort cleanup failure，外部服务器名是动态值。这个源码变体比普通客户端 socket 拒绝更具体。

代表案例 {#case}

本页没有选定的自然 SQL 运行。结构化证据记录的是源码或定义边界；客户端 RAISE 不能代表服务器机制。

版本 {#versions}

上面的生成事实表记录锁定的目录快照和最早观察到的定义。本页没有选定的自然 SQL 运行；固定的 REL_18_6/REL_10_23 源码边界不能当作实测结果，也不能据此推断所有中间版本的行为。

相关 {#related}

• 08001 — sqlclient_unable_to_establish_sqlconnection
• 08006 — connection_failure
• 08007 — transaction_resolution_unknown

来源 {#sources}

• src.fdw-connection.18.6 — contrib/postgres_fdw/connection.c at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 67fc002657f2c7df6d93cbf99c933cbc103907d1857ed77aedbb85099ea4dda0 (source).
• src.fdw-connection.10.23 — contrib/postgres_fdw/connection.c at REL_10_23 commit 02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4; fixed blob SHA-256 8a8b053e4ef599d95d0709744aa1dd5bb20047af9dc29b3f42cfba5785e525c5 (source).
• src.calls.REL_18_6 / src.calls.REL_10_23 — fixed local call scans, SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf / 00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c; these scans preserve the resolved call context used by the claims.

来源

• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 contrib/postgres_fdw/connection.c 第 1033–1036 行 REL_10_23 02991e79f 8a8b053e
• 上游源码 contrib/postgres_fdw/connection.c 第 1369–1372 行 REL_18_6 724edf9bd 67fc0026
• 核验材料 verify/cases/08000/cases.json workspace db1a8c9a
• 核验材料 raw/calls/REL_10_23.jsonl REL_10_23 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl REL_18_6 9ee8a0e8