排查流复制延迟

实用指南 · 上游译文 #93

适用版本以正文为准，未声明统一最低版本。

来源与验证说明

原题: How to troubleshoot streaming replication lag
来源: Nikolay Samokhvalov / Postgres.ai
中文翻译与校订: xiongcc
验证状态: 上游内容已核对；未逐条运行所有示例。（2026-09-10）

原作者：Nikolay Samokhvalov · 英文原文 · 中文翻译与校订：xiongcc

本页目录

PostgreSQL 流复制允许从主服务器到备服务器进行持续的数据复制，以确保高可用并平衡只读负载。然而，复制延迟可能会发生，从而导致数据同步延迟。本文提供了排查和缓解复制延迟的步骤。

识别延迟位置

在分析之前，我们需要了解实际存在延迟的位置，以及位于复制的哪个阶段：

通过 walsender 发送 WAL 流到备服务器的网络传输
通过 walreceiver 从网络接收 WAL 流到备服务器
备服务器上通过 walreceiver 写入 WAL 到磁盘
作为恢复过程的 WAL 应用 (回放)

因此，流复制延迟可以分为三类：

写延迟：事务在主服务器提交后，数据写入备服务器的 WAL 之间的延迟。
刷新延迟：事务写入备服务器的 WAL 后，刷新到磁盘之间的延迟。
应用延迟：事务从刷新到磁盘后，应用到备服务器数据库的延迟。

分析查询

要识别延迟，请使用以下 SQL 查询：

select
  pid,
  client_addr,
  application_name,
  state,
  coalesce(pg_current_wal_lsn() - sent_lsn, 0) AS sent_lag_bytes,
  coalesce(sent_lsn - write_lsn, 0) AS write_lag_bytes,
  coalesce(write_lsn - flush_lsn, 0) AS flush_lag_bytes,
  coalesce(flush_lsn - replay_lsn, 0) AS replay_lag_bytes,
  coalesce(pg_current_wal_lsn() - replay_lsn, 0) AS total_lag_bytes
from pg_stat_replication;

示例

查询结果可能如下所示：

postgres=# select
  pid,
  client_addr,
  application_name,
  state,
  coalesce(pg_current_wal_lsn() - sent_lsn, 0) AS sent_lag_bytes,
  coalesce(sent_lsn - write_lsn, 0) AS write_lag_bytes,
  coalesce(write_lsn - flush_lsn, 0) AS flush_lag_bytes,
  coalesce(flush_lsn - replay_lsn, 0) AS replay_lag_bytes,
  coalesce(pg_current_wal_lsn() - replay_lsn, 0) AS total_lag_bytes
from pg_stat_replication;

   pid   |  client_addr   | application_name | state     | sent_lag_bytes | write_lag_bytes | flush_lag_bytes | replay_lag_bytes | total_lag_bytes
---------+----------------+------------------+-----------+----------------+-----------------+-----------------+------------------+-----------------
 3602908 | 10.122.224.101 | backupmachine1   | streaming |              0 |       728949184 |               0 |                0 |               0
 2490863 | 10.122.224.102 | backupmachine1   | streaming |              0 |       519580176 |               0 |                0 |               0
 2814582 | 10.122.224.103 | replica1         | streaming |              0 |          743384 |               0 |          1087208 |         1830592
 3596177 | 10.122.224.104 | replica2         | streaming |              0 |         2426856 |               0 |          4271952 |         6698808
  319473 | 10.122.224.105 | replica3         | streaming |              0 |          125080 |          162040 |          4186920 |         4474040