57P03

速览

57P03 在连接启动阶段、数据库尚未达到可接受连接状态时发出。固定 guard 区分 startup、shutdown、recovery、禁用 hot standby，以及两种不同的 recovery 尚未达到一致状态。

含义

startup packet 在正常认证完成前被拒绝。所有固定分支都使用 FATAL，因此尝试连接直接结束，不会进入客户端事务。hot-standby 分支不能只看 primary：detail 会区分功能禁用、recovery snapshot 尚未 ready，以及 recovery 尚未达到一致状态。

消息

• startup gate：primary the database system is starting up，FATAL。
• hot standby 禁用：primary the database system is not accepting connections，FATAL；detail 为 Hot standby mode is disabled.。
• recovery snapshot 未 ready：primary the database system is not yet accepting connections，FATAL；detail 为 Recovery snapshot is not yet ready for hot standby.；hint 为 To enable hot standby, close write transactions with more than %d subtransactions on the primary server.。
• recovery 尚未一致：primary the database system is not yet accepting connections，FATAL；detail 为 Consistent recovery state has not been yet reached.。
• shutdown gate：primary the database system is shutting down，FATAL。
• recovery gate：primary the database system is in recovery mode，FATAL。

诊断

记录 primary/detail/hint、startup 阶段、hot-standby 配置、recovery 一致性/snapshot 状态、服务器 ready 日志及目标服务器角色。反复出现带 snapshot detail 的 not yet accepting 指向 hint 所说的 primary 端子事务条件；一致性 detail 则表示 recovery 尚未过早阶段。不要把它当成 INERROR 事务：连接在 session 事务建立前就被拒绝。

处理

按界限退避，等待相关 startup、shutdown 或 recovery 状态转换。若 hot standby 是有意禁用的，要注意 hot_standby 是 PGC_POSTMASTER 设置：修改服务器所属的配置来源后必须重启服务器，SIGHUP/reload 不能激活该设置。若 hint 指向 primary 上长时间写事务，则处理该运维原因。ready 后建立新连接。被拒绝的 startup 路径没有事务可回滚；若此前客户端操作在状态转换中断开，重放前先核对业务结果。

版本

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

相关

57P01、57P04、08001

来源

src/backend/tcop/backend_startup.c#L298-338

src/backend/utils/misc/guc_tables.c#L1895-1903

结构化证据记录保存全部固定 startup gate 以及源码/运行范围。