知识条目 / PostgreSQL

PostgreSQL 复制槽导致 WAL 无法释放怎么办?

确认复制槽是否仍被订阅或备库使用,评估丢失该槽的影响后再删除;活跃槽应修复消费端而不是直接清理。

复制槽保证逻辑复制或备库不会丢失 WAL,但消费端停止后 PostgreSQL 会保留其所需 WAL,造成磁盘持续增长。处理前必须确认槽的用途与数据一致性影响。

处理步骤

  1. 盘点复制槽查询 pg_replication_slots 的 slot_type、active、restart_lsn 与保留 WAL 大小。
  2. 确认消费端状态检查对应订阅、备库或同步工具是否已下线;活跃槽说明消费端仍连接,应优先恢复消费。
  3. 谨慎清理对确认废弃的槽执行 pg_drop_replication_slot;若为逻辑订阅,先解除订阅避免反复重建。
  4. 补充监控对 inactive 槽与保留 WAL 设置阈值告警,并定期核对复制槽与备库清单。

示例

SELECT slot_name, slot_type, active,
       pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS retained,
       restart_lsn
FROM pg_replication_slots
ORDER BY retained DESC;

-- 确认废弃后执行
SELECT pg_drop_replication_slot('slot_name');

删除活跃复制槽会中断逻辑复制或备库同步;删除后可能丢失该槽尚未消费的变更,需业务确认。

关键词

postgresql · replication slot · 复制槽 · wal 堆积 · 逻辑复制 · pg_replication_slots · active

官方文档

同库知识