PostgreSQL / 系统课时
排查复制中断与应用冲突
排查复制中断与应用冲突
逻辑复制突然停止时,最重要的不是立即重建订阅,而是先确认 Apply Worker 是否仍在运行,再从错误类型判断是数据冲突、对象缺失、权限不足还是 Worker 资源异常。本课给出一条可复用的定位与恢复路径,目标是在不扩大数据不一致的前提下恢复增量复制。
学习目标
- 用系统视图判断订阅是否仍有活动 Worker,并识别复制停在哪一侧
- 区分唯一约束冲突、Schema 漂移、权限问题和 Apply Worker 异常
- 在修复根因后安全恢复订阅,并验证复制位置继续推进
先确认复制是否真的中断
先在订阅端检查 pg_stat_subscription。一个已启用且正常工作的订阅通常会有活动 Worker;如果订阅被禁用或 Worker 因错误退出,对应行可能暂时不存在,因此还要同时查看 pg_subscription 的启用状态。
SELECT s.subname,
s.subenabled,
st.pid,
st.received_lsn,
st.latest_end_lsn,
st.last_msg_receipt_time
FROM pg_subscription AS s
LEFT JOIN pg_stat_subscription AS st
ON st.subid = s.oid
WHERE s.subname = 'app_sub';预期结果
subname | subenabled | pid | received_lsn | latest_end_lsn | last_msg_receipt_time
---------+------------+-------+--------------+----------------+-----------------------
app_sub | t | <PID> | <LSN> | <LSN> | <TIME>如果 subenabled = t 但 pid 长时间为空,优先检查订阅端 PostgreSQL 日志;如果 Worker 存在但 LSN 和接收时间持续不变,再检查发布端连通性、复制槽状态和网络。

按错误类型处理根因
约束冲突最常见于订阅端被业务直接写入,随后发布端又复制相同主键或唯一键的数据。此时不要先跳过事务,而应确认哪一侧才是权威数据。若发布端是唯一事实源,可暂停订阅、核对冲突行并清理订阅端错误数据,再让原事务重试。
ALTER SUBSCRIPTION app_sub DISABLE;
SELECT id, email, status
FROM public.customer
WHERE id = 1001;
DELETE FROM public.customer
WHERE id = 1001;
ALTER SUBSCRIPTION app_sub ENABLE;预期结果
ALTER SUBSCRIPTION
id | email | status
------+-------------------+--------
1001 | <VALUE> | <VALUE>
(1 row)
DELETE 1
ALTER SUBSCRIPTION对象缺失或结构不一致通常表现为目标表不存在、列类型不兼容或复制所需列无法匹配。逻辑复制不会替你同步 DDL,因此应先把发布端的 Schema 变更以受控迁移方式应用到订阅端,再恢复订阅。
SELECT to_regclass('public.customer') AS target_table;预期结果
target_table
--------------
<VALUE>
(1 row)<VALUE> 为 public.customer 表示对象存在;若为 NULL,先补齐表结构。若对象存在仍报错,应继续比较列、约束和复制标识,而不是反复重启 Worker。
权限问题要先确认订阅所有者,再根据报错对象补足最小权限。若启用了行级安全策略,也要检查复制执行角色是否被策略阻止。
SELECT s.subname,
r.rolname AS subscription_owner
FROM pg_subscription AS s
JOIN pg_roles AS r
ON r.oid = s.subowner
WHERE s.subname = 'app_sub';预期结果
subname | subscription_owner
---------+--------------------
app_sub | <VALUE>
(1 row)判断是否是 Apply Worker 自身异常
当日志没有明确的数据或权限错误时,检查逻辑复制相关后台进程。Worker 反复消失可能与进程资源上限、订阅端重启、连接失败或内部错误有关;仅仅执行 ENABLE 不能修复这些根因。
SELECT pid,
backend_type,
state,
wait_event_type,
wait_event
FROM pg_stat_activity
WHERE backend_type LIKE 'logical replication%'
ORDER BY pid;预期结果
pid | backend_type | state | wait_event_type | wait_event
-------+-----------------------------+--------+-----------------+------------
<PID> | logical replication worker | <VALUE>| <VALUE> | <VALUE>如果查询没有 Apply Worker,而订阅仍处于启用状态,应结合数据库日志检查 Worker 启动失败原因,并核对逻辑复制 Worker 与后台进程相关配置是否还有容量。
恢复后验证链路继续推进
修复根因并启用订阅后,不要只看“进程出现了”。连续观察两次复制位置和接收时间;发布端有新事务时,received_lsn、latest_end_lsn 应继续向前推进。
SELECT subname,
pid,
received_lsn,
latest_end_lsn,
now() - last_msg_receipt_time AS since_last_message
FROM pg_stat_subscription
WHERE subname = 'app_sub';预期结果
subname | pid | received_lsn | latest_end_lsn | since_last_message
---------+-------+--------------+----------------+-------------------
app_sub | <PID> | <LSN> | <LSN> | <INTERVAL>若位置恢复推进且订阅端抽样数据与发布端一致,才算真正恢复。遇到无法消除的冲突时,跳过远端事务只能作为最后手段,因为它会跳过整笔事务中的所有变更,可能把“复制恢复”变成新的数据不一致。