PostgreSQL / 系统课时
流复制原理与搭建
流复制原理与搭建
本节从一套最小主备环境出发,完成物理流复制配置,并用系统视图确认 WAL 已经经历“主库发送、备库接收、落盘与重放”完整链路。完成后,你能判断复制是没连上、只收到但没重放,还是已经稳定追平。
学习目标
- 理解 WAL Sender、WAL Receiver 与重放进程在流复制中的职责
- 完成主库授权、基础备份与备库启动
- 使用
pg_stat_replication和恢复函数验证发送、接收、重放状态
先看清 WAL 如何到达备库
物理流复制复制的不是 SQL,而是主库产生的 WAL。主库的 WAL Sender 持续把 WAL 记录发送给备库;备库 WAL Receiver 接收后写入本地 WAL,随后恢复进程按顺序重放这些记录,使数据页逐步逼近主库状态。

当 sent_lsn、write_lsn、flush_lsn、replay_lsn 逐步接近时,说明链路正在追平;如果某一位置长期不动,就可以把故障范围缩小到对应阶段。
配置主库允许复制
主库至少要启用 replica 级别 WAL,并允许足够数量的 WAL Sender。下面是 postgresql.conf 的最小配置片段;修改后需要重启主库,因为这些参数属于启动级参数。
wal_level = replica
max_wal_senders = 10
max_replication_slots = 10在主库创建专用复制账号:
CREATE ROLE repl_user
WITH REPLICATION LOGIN PASSWORD '<REPL_PASSWORD>';预期输出:
CREATE ROLE然后在主库 pg_hba.conf 放行备库地址。下面的 <STANDBY_IP>/32 只代表单台备库,实际网段请按部署环境收紧。
host replication repl_user <STANDBY_IP>/32 scram-sha-256配置生效后,重载 pg_hba.conf;而 wal_level、max_wal_senders 等启动级参数必须通过重启实例生效。不要用 trust 代替认证来省略密码。
用基础备份初始化备库
先停止备库 PostgreSQL,并确保目标数据目录为空。随后从备库主机执行 pg_basebackup;把占位符替换为实际主库地址、端口和数据目录。
PGPASSWORD='<REPL_PASSWORD>' pg_basebackup \
-h '<PRIMARY_IP>' \
-p '<PORT>' \
-U repl_user \
-D '<STANDBY_DATA_PATH>' \
-Fp -Xs -P -R预期输出:
<VALUE>/<VALUE> kB (100%), 1/1 tablespace进度中的字节数会随数据量变化。-Xs 在备份期间同步流式获取所需 WAL;在 PostgreSQL 12 及以上,-R 会创建 standby.signal,并写入连接主库所需的 primary_conninfo。
用同一数据目录启动备库:
pg_ctl -D '<STANDBY_DATA_PATH>' start预期输出:
waiting for server to start... done
server started如果实例由 systemd、容器编排或云平台托管,应改用对应的启动方式;核心要求是让该数据目录以 standby 模式启动。
验证发送、接收与重放
先在主库查询复制连接。最关键的是 state 应为 streaming;默认异步复制下,sync_state 通常为 async。
SELECT
application_name,
client_addr,
state,
sync_state,
sent_lsn,
write_lsn,
flush_lsn,
replay_lsn
FROM pg_stat_replication;预期结果:
application_name | client_addr | state | sync_state | sent_lsn | write_lsn | flush_lsn | replay_lsn
------------------+-------------+-----------+------------+----------+-----------+-----------+-----------
<APP_NAME> | <IP> | streaming | async | <VALUE> | <VALUE> | <VALUE> | <VALUE>再到备库确认它处于恢复状态,并已经收到、重放 WAL:
SELECT
pg_is_in_recovery() AS in_recovery,
pg_last_wal_receive_lsn() AS received,
pg_last_wal_replay_lsn() AS replayed;预期结果:
in_recovery | received | replayed
-------------+----------+---------
t | <VALUE> | <VALUE>健康链路中,received 与 replayed 会持续前进;空值通常意味着尚未接收到流式 WAL,长期差距扩大则表示重放速度跟不上接收速度。
断点应该从哪一侧查
主库没有 pg_stat_replication 行时,先检查网络、端口、pg_hba.conf、复制账号和密码;有连接但不是 streaming 时,再看主备日志中的认证、时间线或 WAL 缺失错误。主库视图正常而备库 replayed 长期不前进,则重点检查备库磁盘、恢复冲突和资源瓶颈。
生产环境还要考虑 WAL 保留策略。物理复制槽可以防止主库过早删除备库尚未消费的 WAL,但掉线备库也可能让主库 WAL 无限堆积,因此必须同时监控复制槽滞留量与磁盘空间。