PG主节点挂了，为什么备节点不会自动升主-Go服务器开发

这是一个非常经典且重要的问题。PG（PostgreSQL）主节点挂掉后，备节点没有自动升主，通常是由于自动故障转移机制没有正确配置或生效。

简单来说，PostgreSQL 的核心本身不包含一个内置的、全自动的“集群管理器”。它提供了构建高可用架构的所有必要组件（如流复制、WAL日志），但自动故障转移需要额外的工具或脚本来实现。

以下是导致备节点无法自动升主的几个主要原因，从最常见到最不常见排列：

这是最根本的原因。如果你只是简单地配置了流复制 (primary_conninfo)，那么这只是一个手动切换的物理备用服务器。

要实现自动故障转移，你需要部署以下之一：

Patroni: 目前最流行和强大的开源解决方案。它使用分布式共识存储（如 etcd, ZooKeeper, Consul）来管理集群状态和领导者选举。
repmgr: 另一个流行的开源工具，专门用于管理PostgreSQL复制和故障转移。
Pgpool-II: 一个功能丰富的中间件，可以提供连接池、负载均衡和自动故障转移。
自定义脚本: 自己编写监控脚本，但在生产环境中不推荐，因为很难覆盖所有边缘情况。

如果没有这些工具，备节点就只是在等待指令，它不知道主节点已经挂了，也没有被授权将自己提升为主节点。

即使你部署了 Patroni 或 repmgr，它们也可能因为配置错误而无法工作：

网络分区: 备用节点和管理节点（如etcd）之间的网络中断，导致备用节点无法准确判断主节点的状态。
共识存储故障: Patroni依赖的etcd或Consul集群本身出现故障，导致无法进行可靠的领导者选举。
配置错误:
- 未设置 use_pg_rewind 或配置不正确，导致旧主节点恢复后无法重新加入集群。
- 故障转移条件（如 maximum_lag_on_failover）设置得太严格，备用节点的延迟太大，不符合升主条件。
- 未正确配置 postgresql.promotion 命令或权限。
服务未运行: Patroni/repmgr 的守护进程在备用节点上意外停止。

即使没有自动化工具，理论上也可以通过 trigger_file 来促进备机升主。如果这个也没生效：

trigger_file 未创建： 你的监控系统负责在主节点宕机时创建这个文件。如果监控系统没动作或者路径权限不对，备用节点就无法触发提升。
WAL日志中断： 如果主库在完全宕机前有WAL日志未能传输到备库，备库的数据可能不是最新的。为了数据安全，PostgreSQL默认不会在这种情况下自动提升。你需要确保 wal_keep_size 足够大或者配置了归档（archive_mode）。

primary_conninfo 配置错误： 备用节点无法连接到主节点获取新的WAL日志，但这通常不会阻止它在收到提升命令后成为主库。
recovery.conf (PG12之前) 或 standby.signal (PG12及之后) 文件存在问题： 这个文件明确告诉PostgreSQL实例它当前是一个备用服务器。只要这个文件存在且 primary_conninfo有效，它就会一直保持备用状态。

当发生主节点宕机而备节点未升主的情况时，请按以下步骤排查：

检查备节点的角色：
```
SELECT pg_is_in_recovery();
```
如果返回 t (true)，说明它仍然处于恢复模式（即备机）。如果返回 f (false)，说明它已经是主库了（可能已经成功切换但你不知道）。
检查高可用管理软件的状态：
- Patroni:
```
patronictl list <cluster_name>
```
  查看每个节点的Role和State。
- repmgr:
```
repmgr cluster show
```
检查日志！检查日志！检查日志！ 这是最重要的步骤。查看：
- 备节点的PostgreSQL日志： 寻找关于连接主库失败、WAL接收错误、或者是否检测到了trigger_file等信息。
- 高可用软件的日志（如Patroni日志）： 它会详细记录其决策过程，比如为什么认为主库还活着、为什么不发起故障转移等。
检查网络连通性： 从备节点尝试 ping/telnet 到原主节点的IP和端口（通常是5432），确认网络是否真的不通。
检查是否存在 standby.signal/recovery.conf文件： 在备节点的数据目录下查看是否存在该文件。只要这个文件存在且数据库正在运行中,它就绝不会主动成为主机(除非通过promote信号)。

原因类别	核心问题	解决方案
缺乏自动化工具	只有基础流复制	部署 Patroni, repmgr, Pgpool-II
HA工具配置错误	有工具但没配好	检查网络、共识存储、配置文件、参数阈值
PG自身配置限制	依赖外部触发	检查 `trigger_file`, WAL归档, `primary_conninfo`,