知识条目 / PostgreSQL
PostgreSQL 复制槽导致 WAL 无法释放怎么办?
确认复制槽是否仍被订阅或备库使用,评估丢失该槽的影响后再删除;活跃槽应修复消费端而不是直接清理。
复制槽保证逻辑复制或备库不会丢失 WAL,但消费端停止后 PostgreSQL 会保留其所需 WAL,造成磁盘持续增长。处理前必须确认槽的用途与数据一致性影响。
处理步骤
- 盘点复制槽查询 pg_replication_slots 的 slot_type、active、restart_lsn 与保留 WAL 大小。
- 确认消费端状态检查对应订阅、备库或同步工具是否已下线;活跃槽说明消费端仍连接,应优先恢复消费。
- 谨慎清理对确认废弃的槽执行 pg_drop_replication_slot;若为逻辑订阅,先解除订阅避免反复重建。
- 补充监控对 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
官方文档
同库知识
- PostgreSQL 的 VACUUM 有什么作用?理解死元组清理、可见性映射与事务冻结,区分普通 VACUUM 和 VACUUM FULL 的代价。
- PostgreSQL 锁等待与阻塞如何定位?用 pg_blocking_pids 还原阻塞链,结合事务时长与语句决定安全的处理方式。
- PostgreSQL 报 sorry, too many clients already 如何恢复?区分连接池配置过大、空闲连接不释放与长事务占用,先释放异常会话,再调整 max_connections 与连接池。
- PostgreSQL 出现 idle in transaction 与锁阻塞怎么办?idle in transaction 会长期持有快照与锁并阻止 vacuum,先定位事务为何不结束,再终止异常会话并设置空闲事务超时。
- PostgreSQL WAL 目录暴涨导致磁盘满如何处理?先区分归档失败、复制槽滞留与检查点过慢三类原因,再恢复归档或清理失效复制槽,避免直接删除 pg_wal 文件。