CONFIGURATION PARAMETER复制 / 发送服务器

wal_keep_size

设置为备库保留的 WAL 文件大小。

Sets the size of WAL files held for standby servers.

整数重载生效引入 13 现存至 20 devel 0 次默认值变更

类型: 整数integer
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: 0 B原始值 0 MB
取值范围: 0 – 2147483647
分类: 复制 / 发送服务器
引入版本: 13
状态: 现存

PostgreSQL 18 手册官方文档引入提交 f5dff45962

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

0 B 13 – 20

已记录的默认值在 PostgreSQL 13–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.6 复制本站手册官方原文

本版译文与 PostgreSQL 13 完全一致，下面就是同一段文字。

指定在 pg_wal 目录中保留的旧 WAL 文件的最小总量，以便备库需要时获取这些文件进行流复制。如果连接到发送服务器的备库落后超过 wal_keep_size 兆字节，发送服务器可能会移除备库仍需要的 WAL 段，从而导致复制连接终止。下游连接最终也会因此失败。（不过，如果使用了 WAL 归档，备库可以通过从归档获取该段来恢复。）

此设置只规定 pg_wal 中保留的段的最小总量；系统可能需要为 WAL 归档或从检查点恢复而保留更多段。如果 wal_keep_size 为零（默认值），系统不会为备库额外保留任何段，因此备库可用的旧 WAL 段数取决于前一个检查点的位置和 WAL 归档的状态。如果指定值时没有单位，则按兆字节计算。此参数只能在 postgresql.conf 文件中或服务器命令行上设置。

机制详解

发送端会在 pg_wal 中至少保留 wal_keep_size MB 的历史 WAL，使落后备库不会因旧段过早消失而中断流复制。如果落后距离超过现有文件，流连接会终止；若归档中存在缺失段，备库仍可从归档恢复。

它是保留下限，不是精确预留量，也不是上限。检查点恢复、归档、复制槽以及近期 WAL 用量估计都可能保留更多文件。值为 0 表示不专门为备库额外保留，并不表示 pg_wal 中没有旧 WAL。

复制槽依据各消费者确认位置精确保留 WAL，通常更可靠。wal_keep_size 仍可作为无槽备库或短暂重连的简单保险，但容量应按峰值 WAL 速率乘以预期中断窗口计算。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

优先使用受监控的复制槽和经过验证的归档。确需非零下限时，按峰值 WAL 字节速率与容忍断连时间计算，再增加余量并监控复制延迟。
OLAP分析与批处理

短时间批量导入就可能突破静态保留量。必须跨越此类峰值的消费者应使用复制槽或归档，wal_keep_size 也应按峰值而非平均速率定值。
小规格低配实例与开发机

复制槽和归档恢复可靠时保持 0。否则选择不会在归档或复制槽事故叠加时耗尽磁盘的适度、有界值。

常见问题

把 wal_keep_size 当作 pg_wal 使用量上限。
把 0 理解为“不保留 WAL”，而不是“不为备库额外保留”。
按平均 WAL 速率定值，在批任务峰值时失效。
认为备库超过保留窗口后仍保证可继续复制。
比较 PG12 与 PG13 时漏掉前身参数 wal_keep_segments。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 13 ← 12 新增此参数

PostgreSQL 13 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
13	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
14	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
15	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
16	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
17	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
18	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
19	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`
20 沿用	`0 B`	`MB`	`重载生效`	`整数`	`0`	`2147483647`	`—`

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Replication 复制 12 个 ↗
发送服务器 12
`idle_replication_slot_timeout`	整数	重载生效	`0 s`	—
设置复制槽保持空闲多久后失效。				现存
`max_repack_replication_slots`	整数	重启生效	`5`	—
设置 REPACK 命令可使用的最大复制槽数量。				现存
`max_replication_slots`	整数	重启生效	`10`	102 次
设置可同时定义的复制槽最大数量。				现存
`max_slot_wal_keep_size`	整数	重载生效	`-1 MB`	—
设置复制槽可保留的 WAL 最大大小。				现存
`max_wal_senders`	整数	重启生效	`10`	103 次
设置可同时运行的 WAL sender 进程最大数量。				现存
`output_plugin_libraries`	字符串	会话（超级用户）	`pgoutput, test_decoding`	—
列出可作为逻辑解码输出插件指定的库。				现存
`replication_timeout`	整数	重载生效	`1 min`	—
设置等待 WAL 复制活动的最长时间。				于 9.3 移除
`track_commit_timestamp`	布尔	重启生效	`off`	—
记录事务提交时间。				现存
`wal_keep_segments`	整数	重载生效	`0`	—
设置为备库保留的 WAL 文件数量。				于 13 移除
`wal_keep_size`	整数	重载生效	`0 B`	—
设置为备库保留的 WAL 文件大小。				现存
`wal_sender_shutdown_timeout`	整数	会话	`-1 ms`	—
设置关机时等待 WAL 全部复制到接收端的最长时间。				现存
`wal_sender_timeout`	整数	会话	`1 min`	121 次
设置等待 WAL 复制活动的最长时间。				现存

快速链接