PostgreSQL / 系统课时
读取复制状态与 LSN
读取复制状态与 LSN
判断逻辑复制“走到哪里”,不能只看订阅是否显示为运行中。本课把发布端发送器、逻辑复制槽、订阅端 worker 与 LSN 串成一条观察链,读完后可以用系统视图定位数据是在发送、接收还是应用阶段出现停顿。
学习目标
- 读懂
pg_stat_replication、pg_replication_slots与pg_stat_subscription的关键字段 - 用 LSN 的先后关系判断发送、确认与应用进度
- 根据状态缺口快速区分断连、积压和 WAL 保留风险
先建立 LSN 观察链
LSN 是 WAL 中的位置标记,会随 WAL 写入向前推进。它适合回答“两个复制阶段相差多少 WAL”,但不是时间戳,不能直接把 LSN 差值解释成几秒延迟。
逻辑复制至少要同时看三个位置:发布端当前 WAL 与 walsender 的发送反馈、逻辑复制槽的 confirmed_flush_lsn、订阅端 worker 的接收位置。只看其中一个位置,很容易把“网络没收到”和“已经收到但还没处理”混为一谈。

在发布端读取发送器和复制槽
先在发布端执行下面的查询。第一条看当前活跃的 WAL sender 以及订阅端反馈的位置,第二条看逻辑复制槽是否活跃、最早仍需保留的 WAL,以及订阅端已经确认消费到哪里。
SELECT
application_name,
client_addr,
state,
sent_lsn,
write_lsn,
flush_lsn,
replay_lsn,
sync_state
FROM pg_stat_replication
ORDER BY application_name;
SELECT
slot_name,
active,
restart_lsn,
confirmed_flush_lsn,
pg_size_pretty(
pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn)
) AS wal_gap
FROM pg_replication_slots
WHERE slot_type = 'logical'
ORDER BY slot_name;预期结果
application_name | client_addr | state | sent_lsn | write_lsn | flush_lsn | replay_lsn | sync_state
<NAME> | <IP> | streaming | <LSN> | <LSN> | <LSN> | <LSN> | async
slot_name | active | restart_lsn | confirmed_flush_lsn | wal_gap
<NAME> | t | <LSN> | <LSN> | <VALUE>实际名称、地址和 LSN 会不同。state = streaming 说明 sender 正在传输;active = true 说明复制槽当前被消费者占用。confirmed_flush_lsn 是逻辑槽收到的消费确认位置,而 restart_lsn 是该槽仍可能需要的最早 WAL 位置。两者都应持续前移,但含义不同。
这里的 wal_gap 用发布端当前 WAL 减去槽的确认位置,可作为“尚未被该槽确认的 WAL 距离”观察值。它包含整个集群产生的 WAL 位置推进,不等同于某张业务表还差多少行。
在订阅端确认接收进度
再到订阅端读取 pg_stat_subscription。一个订阅可能同时出现主 apply worker 和表同步 worker,因此不要只假设一行结果。
SELECT
subname,
pid,
relid,
received_lsn,
latest_end_lsn,
last_msg_send_time,
last_msg_receipt_time,
latest_end_time
FROM pg_stat_subscription
ORDER BY subname, relid NULLS FIRST;预期结果
subname | pid | relid | received_lsn | latest_end_lsn | last_msg_send_time | last_msg_receipt_time | latest_end_time
<NAME> | <PID>| | <LSN> | <LSN> | <TIME> | <TIME> | <TIME>received_lsn 用来观察订阅端收到的 WAL 位置;last_msg_receipt_time 可以判断复制连接最近是否还有消息活动。latest_end_lsn 与 latest_end_time 是协议层的最新结束位置与时间信息,适合辅助判断链路是否持续推进,但不能替代业务数据是否已经可见的验证。
用位置差判断卡在哪一段
判读时按数据流方向逐段比较,而不是先猜参数问题。发布端没有 pg_stat_replication 行,通常先检查订阅是否启用、网络、认证和连接配置;有 sender 但复制槽 active = false,说明当前没有消费者占用该槽。
如果 sent_lsn 持续前移,而订阅端的 received_lsn 长时间不动,优先检查网络、接收端进程和连接稳定性。如果订阅端持续收到消息,但槽的 confirmed_flush_lsn 很久不前移,则需要继续检查 apply worker、目标端锁等待、资源瓶颈或复制错误。
restart_lsn 长时间落后还意味着发布端必须继续保留更老的 WAL。迁移期间应同时监控 pg_wal 空间和槽状态,避免“业务复制还在追平,但发布端先被保留 WAL 撑满磁盘”。
LSN 最有价值的用法不是得到一个孤立数字,而是建立“发送位置 → 接收位置 → 确认位置”的连续证据链。只要这些位置持续前移,就能判断复制还在工作;哪个位置先停止推进,通常就是下一步排查的边界。