# 08004 — 服务器拒绝建立 SQL 连接（sqlserver_rejected_establishment_of_sqlconnection）

> PostgreSQL SQLSTATE 08004（服务器拒绝建立 SQL 连接，sqlserver_rejected_establishment_of_sqlconnection）的源码证据、诊断与处理参考。
---

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

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

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

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

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

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

## 含义 {#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](../08001/)
- [`28000` — invalid_authorization_specification](../28000/)
- [`28P01` — 相关条件](../28p01/)

## 来源 {#sources}

- `src.errcodes.18.6` — `src/backend/utils/errcodes.txt` at `REL_18_6` commit `724edf9bde9d356724ad384a2e196edc3c9f80f7`; fixed blob SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt)).
- `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.