常见错误码

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

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

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