PostgreSQL 复制槽与 WAL 积压治理（清理、告警与验证）

---

title: PostgreSQL 复制槽与 WAL 积压治理（清理、告警与验证）

date: 2025-11-26

keywords:

• 复制槽
• WAL 积压
• 清理
• 告警
• 监控

description: 管理逻辑/物理复制槽与WAL积压，设置阈值与告警并在订阅异常时安全清理，提供查询与验证方法确保主库空间与一致性。

tags:

• PostgreSQL
• WAL 积压
• 告警
• 复制槽
• 数据与存储
• 数据库
• 清理
• 监控

categories:

• 文章资讯
• 技术教程

---

概述

复制槽保留WAL以供订阅消费, 订阅停止会导致WAL积压与磁盘膨胀。通过阈值监控与安全清理流程可避免空间耗尽并保持一致性。

关键实践与参数

• 参数: wal_level=logical max_replication_slots max_wal_senders max_slot_wal_keep_size
• 监控: pg_replication_slots pg_stat_subscription 与磁盘使用
• 告警阈值: WAL大小与滞后时间
• 清理流程: 确认订阅停用 → 导出位点 → 删除或重建槽

示例/配置/实现

SELECT slot_name, active, restart_lsn, pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS backlog FROM pg_replication_slots;
SELECT subname, latest_end_time, last_msg_receipt_time FROM pg_stat_subscription;

-- 停用并删除无效槽(谨慎)
SELECT pg_drop_replication_slot('stale_slot');

-- 设置槽保留大小限制(>=PG14)
ALTER SYSTEM SET max_slot_wal_keep_size = '8GB';
SELECT pg_reload_conf();

验证

• 背压下降: 删除或恢复订阅后WAL积压减少
• 空间安全: 磁盘使用回到阈值以内
• 一致性: 有效订阅无事件丢失, 位点管理正确
• 告警: 在滞后与空间超限时触发告警

注意事项

• 删除槽会丢弃其未消费的WAL, 必须确认安全
• 为关键订阅设置保留限制与自动告警
• 在维护窗口执行清理并留有回退方案
• 保持Schema一致与订阅健康