08006 — 连接失败

速览 {#at-a-glance}

SQLSTATE 08006 是 Class 08 中的 connection_failure。08006 表示已有连接发生故障。固定路径包括 postgres_fdw 的取消/连接丢失处理以及 COPY 失败处理；它们没有一个适用于所有路径的主报文或严重级别，本批也有意不做普通 socket 的伪案例。

含义 {#meaning}

固定源码路径说明了为什么本类没有统一报文。在 postgres_fdw 中，取消请求失败时，在处理已有外部连接的过程中发出 WARNING；这是取消路径的诊断，本身不证明客户端会话已经终止。在 COPY 路径中，带有未完成事务的客户端 EOF 以 ERROR 报告，而较旧的 COPY-to-stdout 路径在输出连接丢失时以 FATAL 报告。严重级别和发生阶段都是含义的一部分，不能把它们合并成“socket 断了”。

ERROR 分支若发生在显式事务中，仍连接着的会话可能进入 INERROR，调用者应先 ROLLBACK 或回到合适的保存点再执行无关 SQL。FATAL 分支会结束后端连接，不存在可以发送 ROLLBACK 的会话。已经读到 EOF 的客户端也可能根本没有 SQLSTATE。这里的证据确认这些源码分支，但没有声称每次普通网络断开都会发出 08006。

分支指引 {#scenarios}

| 固定分支 | 它说明什么 | 首先检查什么 | | --- | --- | --- | | postgres_fdw 取消 WARNING | 已建立的外部连接上，取消请求无法发送或无法读取结果。 | 保留动态 libpq 文本、FDW 操作和本地事务状态；WARNING 本身不说明本地会话已关闭。 | | COPY 客户端 EOF ERROR | 服务器在 COPY 相关连接仍有未完成事务时检测到 EOF。 | 触发该分支的客户端 socket 已经到达 EOF，不能在其上发送 ROLLBACK 或复用；应重新连接并核对 COPY 结果。 | | COPY-to-stdout FATAL | 固定的 10.23 路径在 COPY 期间丢失输出连接，并使用 fatal 级别。 | 丢弃后端连接并核对已经发送或接收的数据；不能执行会话级回滚。 | | 普通客户端 EOF | 对端在固定服务器分支之外消失。 | 结合驱动/socket 和服务器日志；不要仅凭客户端 null SQLSTATE 指定 08006。 |

诊断 {#diagnosis}

关联后端 PID、操作、服务器日志字段和客户端异常。客户端断 socket 可能得到 null SQLSTATE，而服务器端 FDW 或 COPY 路径可能发出带路径特定文本的 08006。决定是否重试前，区分 08001（尚未建立连接）、08007/40003（完成结果不确定）和语句尚未执行成功的普通错误。

要同时检查严重级别和生命周期。WARNING 表示 FDW 取消分支中本地会话可能仍然存活；ERROR 要检查 INERROR 还是 IDLE，必要时恢复事务；FATAL 表示后端已消失。如果客户端在 ErrorResponse 之前只读到 EOF，没有 SQLSTATE 是线路交换丢失的正常证据，不能据此认定 08006。

处理 {#response}

丢弃连接池标记为损坏的连接，核对远端或非幂等操作的结果，并在明确幂等策略后重试完整操作。本页只确认固定源码边界；没有用 RAISE、超时或普通断 socket 冒充实测 08006。

对另一个仍保持连接的 ERROR 情形，应先回滚失败的显式事务（或回滚到围绕该操作有意建立的保存点），再决定能否重试完整操作。这个一般事务规则不能证明 COPY 客户端 EOF socket 可复用：源码分支已经检测到该客户端连接的 EOF。FATAL 或已经丢失的 socket 则要建立新会话，并在任何重放前核对结果。自动提交不会让远端或 COPY 操作自动具备幂等性，它只改变本地事务边界。

报文 {#messages}

固定分支包含以下不同诊断：

• postgres_fdw 取消路径的 WARNING：could not send cancel request: %s，其中 libpq 错误文本是动态值。
• 同一 FDW 路径的 WARNING：could not get result of cancel request: %s，返回的连接错误文本是动态值。
• 固定 10.23 COPY 路径的 FATAL：connection lost during COPY to stdout。
• 固定 18.6/10.23 COPY 客户端 EOF 路径的 ERROR：unexpected EOF on client connection with an open transaction。

证据将这些变体分开记录；普通客户端断 socket 得到的 null SQLSTATE 不能被提升为 08006。

即使报文都提到连接，ERROR 与 FATAL 也有不同的恢复契约。COPY 客户端 EOF 的 ERROR 分支检测到客户端 socket 已经消失；它不建立可复用 socket，也不提供在该连接上发送 ROLLBACK 的路径。后者属于 COPY-to-stdout 路径，会关闭后端。本批没有自然 08006 运行，因此这些差异来自固定源码路径和文档规定的事务边界，而不是合成的 socket 实验。

代表案例 {#case}

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

版本 {#versions}

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

相关 {#related}

• 08001 — sqlclient_unable_to_establish_sqlconnection
• 08007 — transaction_resolution_unknown
• 40003 — 相关条件

来源 {#sources}

• src.fdw-connection-failure.18.6 — contrib/postgres_fdw/connection.c at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 67fc002657f2c7df6d93cbf99c933cbc103907d1857ed77aedbb85099ea4dda0 (source).
• src.copy-connection-failure.10.23 — src/backend/commands/copy.c at REL_10_23 commit 02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4; fixed blob SHA-256 0edb032be1ce8d8c90efc28e504aa9e298a2cd26cd374c85da6da0e33ed0915c (source).
• src.copy-client-eof.18.6 — src/backend/commands/copyfromparse.c at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 bc42754023579cd782a3cb3f144ad2c2c3d3aa46119eb7567fcdb05f2d445571 (source).
• src.copy-client-eof.10.23 — src/backend/commands/copy.c at REL_10_23 commit 02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4; fixed blob SHA-256 0edb032be1ce8d8c90efc28e504aa9e298a2cd26cd374c85da6da0e33ed0915c (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.

来源

• 上游源码 doc/src/sgml/xact.sgml PG18-docs 724edf9bd b48fbe8b
• 上游源码 src/backend/commands/copy.c 第 587–614 行 REL_10_23 02991e79f 0edb032b
• 上游源码 src/backend/commands/copyfromparse.c 第 276–303 行 REL_18_6 724edf9bd bc427540
• 上游源码 src/backend/commands/copy.c 第 525–527 行 REL_10_23 02991e79f 0edb032b
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 contrib/postgres_fdw/connection.c 第 1462–1464 行 REL_18_6 724edf9bd 67fc0026
• 核验材料 verify/cases/08006/cases.json workspace 205dd837
• 核验材料 raw/calls/REL_10_23.jsonl REL_10_23 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl REL_18_6 9ee8a0e8