PostgreSQL主从切换如何平滑执行？failover机制怎么配置才稳定

PostgreSQL的主从架构基于流复制实现，当主库不可用时，通过failover机制将备库提升为新主库，完成主从切换。平滑切换的核心是尽量减少数据丢失，同时缩短服务中断时间，这需要提前做好配置和预案。

PostgreSQL failover机制核心原理

PostgreSQL的流复制分为异步复制和同步复制两种模式，failover的行为和稳定性与复制模式直接相关。异步复制下备库可能存在少量数据延迟，切换时可能丢失最近几秒的未同步数据；同步复制则要求主库事务提交前必须等待至少一个备库接收并写入WAL日志，数据一致性更高，但会增加主库写入延迟。

failover的本质是备库停止从原主库接收WAL日志，将自己提升为可写的主库，同时通知其他备库连接到新的主库继续同步。整个过程不需要重启数据库服务，仅需要调整复制关系和状态标识。

主从切换前的准备配置

1. 基础流复制配置

首先确保主从流复制正常运行，主库的postgresql.conf需要开启以下配置：

-- 主库postgresql.conf核心配置
wal_level = replica  -- 开启WAL日志复制级别
max_wal_senders = 10  -- 最大WAL发送进程数，根据备库数量调整
wal_keep_size = 1GB  -- 保留足够的WAL日志，避免备库落后过多无法同步
synchronous_standby_names = 'ANY 1 (*)'  -- 同步复制配置，可选，根据需求开启

备库的postgresql.conf需要配置hot_standby = on允许只读查询，同时创建standby.signal文件标识自己是备库，primary_conninfo配置指向主库的连接信息：

-- 备库postgresql.conf核心配置
hot_standby = on  -- 开启备库只读功能
primary_conninfo = 'host=原主库IP port=5432 user=repl_user password=repl_password'  -- 指向主库的连接串

2. 配置自动failover工具（可选）

手动切换适合计划内的维护场景，生产环境建议搭配自动failover工具，常用的有Patroni、Repmgr等，这里以Repmgr为例做基础配置。备库安装Repmgr后，配置repmgr.conf：

node_id=2  -- 备库节点ID，全局唯一
node_name=node2  -- 备库节点名称
conninfo='host=备库IP port=5432 user=repmgr dbname=repmgr'
data_directory='/var/lib/postgresql/14/main'  -- 数据库数据目录
failover=automatic  -- 开启自动failover
promote_command='repmgr standby promote -f /etc/repmgr.conf --log-to-file'
follow_command='repmgr standby follow -f /etc/repmgr.conf --log-to-file --upstream-node-id=%n'

平滑执行主从切换的步骤

场景一：计划内主从切换（手动切换）

计划内切换比如主库需要做硬件维护，步骤如下：

• 第一步：检查主从同步状态，确保备库没有落后太多，执行以下SQL查询主库WAL发送状态：

SELECT pid, state, client_addr, sent_lsn, write_lsn, flush_lsn, replay_lsn 
FROM pg_stat_replication;

• 第二步：将原主库设置为只读，避免新数据写入导致切换后数据不一致：

-- 主库执行，设置全局只读
SET GLOBAL read_only = on;  -- 注意：如果是超级用户需要额外限制，可通过修改配置文件重启生效更稳妥

• 第三步：等待备库同步完所有WAL日志，确认replay_lsn和主库的current_wal_lsn一致后，在备库执行提升命令：

-- 备库服务器执行命令
pg_ctl promote -D /var/lib/postgresql/14/main

• 第四步：将原主库修改为备库，指向新的主库，创建standby.signal文件，修改primary_conninfo后启动即可。

场景二：主库故障的failover切换

主库突然宕机时，若配置了自动failover工具，工具会自动检测主库不可用，将备库提升为新主库；若手动执行，步骤如下：

• 第一步：确认主库确实无法恢复，检查备库最新的WAL接收情况，选择数据最新的备库作为新主库。
• 第二步：在选中的备库执行提升命令，和计划内切换的第三步一致。
• 第三步：通知应用层修改数据库连接地址指向新主库，其他备库执行repmgr standby follow命令指向新主库继续同步。

切换后的检查与注意事项

切换完成后需要检查以下几点：

• 检查新主库的写入功能是否正常，执行简单的新增数据操作验证。
• 检查其他备库的复制状态，确认pg_stat_replication视图中有新的连接记录。
• 检查应用的连接池是否都指向了新主库，避免出现部分请求仍然访问旧主库的情况。
• 如果是异步复制切换，需要排查可能丢失的数据，和业务方确认数据一致性。

另外需要注意，切换过程中不要同时操作多个备库提升，避免产生多个主库导致数据冲突。如果使用了连接中间件，需要在中间件层配置自动感知主库变更，减少人工修改配置的成本。

常见问题与解决方案

PostgreSQL主从切换failover流复制修改时间：2026-07-07 15:42:47