# 常见错误码

> 面向故障排查精选的 SQLSTATE 入口。
---

这里按常见排查路径提供编辑精选入口，不代表生产环境频率排名；每一行说明该条目帮助回答的具体问题，并保留其审阅状态。

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

| 错误码 | 条件名 | 入口说明 |
| --- | --- | --- |
| [`23505`](../23505/) | `unique_violation` | 重复键、约束冲突与幂等写入。 |
| [`23503`](../23503/) | `foreign_key_violation` | 外键修复与依赖顺序。 |
| [`23502`](../23502/) | `not_null_violation` | 必填值缺失与输入校验。 |
| [`23514`](../23514/) | `check_violation` | CHECK 约束与不变量失败。 |
| [`23P01`](../23p01/) | `exclusion_violation` | 排除约束与范围冲突。 |
| [`40P01`](../40p01/) | `deadlock_detected` | 死锁诊断、回滚与锁顺序。 |
| [`40001`](../40001/) | `serialization_failure` | 可串行化重试与新事务快照。 |
| [`25P02`](../25p02/) | `in_failed_sql_transaction` | 错误后必须处理的失败事务状态。 |
| [`42P01`](../42p01/) | `undefined_table` | 关系不存在与 search_path 诊断。 |
| [`42601`](../42601/) | `syntax_error` | 语句执行前的语法错误。 |
| [`42501`](../42501/) | `insufficient_privilege` | 权限检查与授权失败。 |
| [`28P01`](../28p01/) | `invalid_password` | 密码认证与连接建立。 |
| [`57014`](../57014/) | `query_canceled` | 取消、statement_timeout 与后续操作。 |
| [`53300`](../53300/) | `too_many_connections` | 连接上限与接入失败。 |
| [`2202E`](../2202e/) | `array_subscript_error` | 数组维度、拼接与类型规则。 |
| [`01000`](../01000/) | `warning` | 警告分发与非错误诊断。 |
| [`P0001`](../p0001/) | `raise_exception` | 应用定义的 PL/pgSQL 异常。 |
| [`XX000`](../xx000/) | `internal_error` | 内部错误的安全边界与升级处理。 |

<!-- END SQLSTATE INDEX -->

---

反链：

- [SQLSTATE 大典](/zh/)