08004 — 服务器拒绝建立 SQL 连接

速览 {#at-a-glance}

SQLSTATE 08004 是 Class 08 中的 sqlserver_rejected_establishment_of_sqlconnection。08004 是 SQL 标准中“服务器拒绝建立连接”的名称。固定的 PostgreSQL 18.6 与 10.23 核心调用扫描没有解析出该码的 PostgreSQL ereport 路径。

含义 {#meaning}

08004 是 SQL 标准中“服务器拒绝建立连接”的名称。固定的 PostgreSQL 18.6 与 10.23 核心调用扫描没有解析出该码的 PostgreSQL ereport 路径。

诊断 {#diagnosis}

用服务器 ErrorResponse 和认证日志识别具体条件。本范围内 PostgreSQL 路径使用 28000、28P01 等更具体的码；只有客户端异常、没有服务器字段时，不能据此认定 08004。

处理 {#response}

修复实际认证、授权或端点问题后建立新连接。本页只记录定义与源码边界，不用客户端 RAISE 或伪造登录失败来冒充自然机制。

报文 {#messages}

本范围没有确认 08004 的固定主报文模板；现有定义/源码记录不足以建立固定文本。只有客户端异常而没有匹配的服务器诊断时，不能据此认定 08004。

代表案例 {#case}

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

版本 {#versions}

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

相关 {#related}

• 08001 — sqlclient_unable_to_establish_sqlconnection
• 28000 — invalid_authorization_specification
• 28P01 — 相关条件

来源 {#sources}

• src.errcodes.18.6 — src/backend/utils/errcodes.txt at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba (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
• 核验材料 verify/cases/08004/cases.json workspace 533ef5ec
• 核验材料 raw/calls/REL_10_23.jsonl REL_10_23 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl REL_18_6 9ee8a0e8