57P02 — crash_shutdown
57P02
速览
57P02 是 crash-shutdown 路径。crash-and-restart 周期开始时，backend 向客户端发送 client-only WARNING，说明 postmaster 命令其回滚并退出；随后由于共享内存可能已损坏，进程不运行正常清理回调而退出。
| 字段 | 值 |
|---|---|
| SQLSTATE | 57P02 |
| 条件名 | crash_shutdown |
| 状态 | 有效 |
| 已知存在于 | 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_CRASH_SHUTDOWN |
| 别名 | — |
含义
固定 primary 是 terminating connection because of crash of another server process。detail 说明 postmaster 因另一个服务器进程异常退出、可能破坏共享内存，而命令当前 server process 回滚并退出；hint 建议稍后重连。源码使用 WARNING_CLIENT_ONLY 而不是 FATAL，使信号处理器能先把消息发给客户端再强制进程退出。连接仍会关闭，之后不能在原 session 发送普通恢复命令。
消息
- primary：
terminating connection because of crash of another server process。 - detail：
The postmaster has commanded this server process to roll back the current transaction and exit, because another server process exited abnormally and possibly corrupted shared memory. - hint：
In a moment you should be able to reconnect to the database and repeat your command. - severity 来源：
WARNING_CLIENT_ONLY，这是发给客户端但不写服务器日志的 warning；报告后进程退出。因此不能把它理解成可在同一 session 继续的语句级 WARNING。
诊断
把 SQLSTATE 和完整诊断与 postmaster 崩溃/恢复日志、backend PID 及执行中的命令关联。源码明确要求回滚当前事务，但连接在 crash 周期中断开，重放非幂等请求前仍必须核对持久化业务状态。要和有序管理员 shutdown（57P01）及启动拒绝（57P03）区分。
处理
不要在已断开的连接上发送 ROLLBACK，也不要人为制造崩溃测试此路径。等待 postmaster 恢复并 ready，建立新连接，检查持久化业务状态和受影响对象；只有在操作幂等或已确认先前效果后再重试。保留 primary/detail/hint 及服务器日志用于事故诊断。
版本
锁定目录从 7.4 记录此条件；该目录边界不等于精确实现引入版本。固定源码覆盖 PostgreSQL 18.6。
相关
来源
src/backend/tcop/postgres.c#L2974-3001
src/include/utils/elog.h#L46-55
结构化证据记录保存固定消息以及源码/运行范围。