58000 system_error

速览

58000 是 system-error 条件。在固定 backend 路径中，pg_promote 创建 promotion signal 文件后调用 kill(PostmasterPid, SIGUSR1)；信号发送失败时以 ERROR 报告，并把操作系统的 %m 文本展开到消息中。

含义

代表性 backend primary 是 failed to send signal to postmaster: %m。代码在报告 ERROR 前先删除 promotion signal 文件，所以这里是 postmaster 通知路径中的系统调用失败，不是用户值或 SQL 语法错误。共享的 common/exec.c 使用 log_error 宏，并有两个编译时分支：非 FRONTEND 构建展开为 ereport(LOG, (errcodefn, errmsg_internal(...)))；FRONTEND 构建忽略 errcode() 参数，把格式化文本写到 stderr。因此 frontend 工具消息不能证明存在客户端协议 58000 诊断，也不能证明客户端事务已回滚。common/logging.h 中独立的 pg_log_error 宏才映射到 PG_LOG_ERROR，但 pclose_check() 并不调用它。

消息

• backend pg_promote 信号路径：primary 为 failed to send signal to postmaster: %m，severity 为 ERROR；展开文本取决于失败 kill() 调用当时的 OS errno。
• 共享的 pclose_check() 源码：调用点模板是 %s() failed: %m；对 pclose() 会展开为 pclose() failed: <OS 文本>。非 FRONTEND 构建经 ereport(LOG) 携带传入的 ERRCODE_SYSTEM_ERROR；FRONTEND 构建忽略该 code、直接写 stderr，因此不是客户端协议 58000 路径。

诊断

保留 %m 展开后的完整 primary、操作类型（promotion signal、pclose 或其他系统 helper）、进程身份及服务器或工具日志上下文。对 backend pg_promote，检查 postmaster PID、信号权限/进程存活状态和 OS 错误。没有实际 errno 时，不要把系统错误替换成笼统的磁盘、权限或进程诊断；单凭 SQLSTATE 也不能判断事务结果。

处理

先修正展开消息所指出的操作系统条件，再确认 postmaster/服务器健康后重试。backend ERROR 通常会使当前显式事务进入错误状态，继续前先执行 ROLLBACK 或 ROLLBACK TO SAVEPOINT；autocommit 下也应在原因修正后再重试。pclose_check 的 frontend 日志由工具自身控制流处理，不应据此要求 SQL 回滚。若连接已断开，待服务器 ready 后重连并核对业务效果。

版本

锁定目录从 9.2.0 记录此条件；该目录边界不等于精确实现引入版本。固定源码覆盖 PostgreSQL 18.6。

相关

57P01、57P02、XX000

来源

• 上游源码 src/backend/utils/errcodes.txt 第 444 行 REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/access/transam/xlogfuncs.c 第 706 行 REL_18_6 724edf9bd 6373dff2
• 上游源码 src/common/exec.c 第 391 行 REL_18_6 724edf9bd b39dfdb5
• 上游源码 src/include/common/logging.h 第 106 行 REL_18_6 724edf9bd ca990bba
• 上游源码 src/common/exec.c 第 52 行 REL_18_6 724edf9bd b39dfdb5