pg_waldump 和 pg_xlogdump

在 PostgreSQL 里，pg_waldump和pg_xlogdump本质上是同一个工具的不同时代名字，区别主要在版本和命名演进，而不是功能层面。

一句话结论

• pg_xlogdump：旧名字（PostgreSQL ≤ 9.6）
• pg_waldump：新名字（PostgreSQL ≥ 10）
• 功能基本一致，都是用来解析和查看 WAL（Write-Ahead Log）内容

背景：为什么改名？

从PostgreSQL 10 开始，官方做了一次非常重要的术语统一：

目的：
👉让概念更清晰，避免 “xlog / wal 混用” 给运维和新手带来理解成本。

具体对比

1️⃣ pg_xlogdump（已废弃）

• 适用版本：PostgreSQL 9.6 及以前
• 解析对象：pg_xlog/目录下的 WAL 文件
• 命令示例：

pg_xlogdump 00000001000000000000000A

⚠️ PostgreSQL 10+不再提供该命令

2️⃣ pg_waldump（当前标准）

• 适用版本：PostgreSQL 10 及以后
• 解析对象：pg_wal/目录下的 WAL 文件
• 命令示例：

pg_waldump pg_wal/00000001000000000000000A

• 支持更完善的过滤参数：

pg_waldump\--rmgr=Heap\--limit=20\--start=0/16B6C50\pg_wal/00000001000000000000000A

功能层面有没有区别？

👉几乎没有本质区别

二者都能：

• 查看 WAL record 类型（INSERT / UPDATE / COMMIT / CHECKPOINT）

• 分析复制延迟、WAL 堆积

• 排查：

  • replication slot 导致 WAL 无法回收
  • 备库 / logical decoding 卡住
  • 异常 checkpoint / 大事务

PostgreSQL 10+ 的pg_waldump只是：

• 命名更规范
• 输出字段略有增强
• 与新 rmgr / WAL record 类型保持一致

运维视角（结合你最近在看的 WAL / 复制槽问题）

你之前在关注复制槽 + WAL 堆积 + max_slot_wal_keep_size，这里给你一个典型用法场景：

# 看某个 WAL 里是不是一直在产生大量 heap recordpg_waldump --rmgr=Heap --limit=50pg_wal/0000000100000000000000AF

或者定位某个 LSN 附近发生了什么：

pg_waldump --start=0/2A000000 --end=0/2A010000 pg_wal/0000000100000000000000AF

这在分析：

• 逻辑复制 slot 阻塞
• 订阅端长期不消费
• WAL 无法回收

时非常有价值。

总结表