CONFIGURATION PARAMETER预写式日志 / 检查点

min_wal_size

只要 WAL 磁盘用量保持在这个设置之下，在检查点时旧的 WAL 文件总是被回收以便未来使用，而不是直接被删除。

Sets the minimum size to shrink the WAL to.

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

类型: 整数integer
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: 80 MiB原始值 80 MB
取值范围: 2 – 2147483647
分类: 预写式日志 / 检查点
引入版本: 9.5
状态: 现存

PostgreSQL 18.7 手册官方文档引入提交 88e9823026

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

80 MiB (5 × 16MB) 9.5 – 9.6 80 MiB 10 – 19

默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.5 预写式日志本站手册官方原文

只要 WAL 磁盘用量保持在这个设置之下，在检查点时旧的 WAL 文件总是被回收以便未来使用，而不是直接被删除。这可以被用来确保有足够的 WAL 空间被保留来应付 WAL 使用的高峰，例如运行大型的批处理任务。如果指定值时没有单位，则以兆字节为单位。默认是 80 MB。这个参数只能在 postgresql.conf 或者服务器命令行中设置。

机制详解

设置 WAL 可收缩到的最小规模。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

低于该下限时，检查点会保留旧 WAL 段供复用而不是删除。它是保留/回收空间的下限，不是上限；归档失败、复制槽、wal_keep_size 与 max_wal_size 都可能让 pg_wal 远大于它。

应把 min_wal_size 与 max_wal_size、wal_keep_size、wal_segment_size 一起监控和变更。先在对应角色与真实负载上验证，再按其 sighup context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。

调优建议

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

OLTP在线事务处理

按检查点之间的常态 WAL 生成量与文件创建成本设置回收池下限；它应明显低于可用 pg_wal 空间，并与 max_wal_size 一起测量。
OLAP分析与批处理

大批装载可受益于更大的预留回收池，但应依据可重复批次峰值，而不是照搬任意 GB 数；归档与复制槽空间另算。
小规格低配实例与开发机

对小盘这不是免费的默认值，调低时要接受更多段创建/删除抖动。

常见问题

把它理解成 pg_wal 上限。
不考虑 wal_segment_size 取整和突发速率。
忽略归档/复制槽保留可同时越过 min_wal_size 与 max_wal_size。
混淆 pg_settings 的原始单位与配置文件可读单位。
只做吞吐基准，不做崩溃恢复与归档还原。

演化历史

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

PostgreSQL 10 ← 9.6 默认值变更

默认值 80 MiB (5 × 16MB) 80 MiB 单位 16MB MB
PostgreSQL 9.5 ← 9.4 新增此参数

PostgreSQL 9.5 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.5	`80 MiB (5 × 16MB)`	`16MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
9.6	`80 MiB (5 × 16MB)`	`16MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
10	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
11	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
12	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
13	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
14	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
15	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
16	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
17	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
18	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
19	`80 MiB`	`MB`	`重载生效`	`整数`	`2`	`2147483647`	`—`
20	—	—	—	`整数`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Write-Ahead Log 预写式日志 7 个 ↗
检查点 7
`checkpoint_completion_target`	浮点	重载生效	`0.9`	141 次
指定检查点完成所用时间的目标值，以检查点之间总时间的比例表示。				现存
`checkpoint_flush_after`	整数	重载生效	`256 KiB (32 × 8kB)`	—
当执行检查点时写入的数据量超过此数量时，就尝试强制 OS 把这些写发送到底层存储。				现存
`checkpoint_segments`	整数	重载生效	`3`	—
自动 WAL 检查点之间日志文件段的最大数量（每个段通常为 16 兆字节）。				于 9.5 移除
`checkpoint_timeout`	整数	重载生效	`5 min`	9.61 次
自动 WAL 检查点之间的最长时间。				现存
`checkpoint_warning`	整数	重载生效	`30 s`	—
如果由于填充 WAL 段文件导致的检查点之间的间隔低于这个参数表示的时间量，那么就向服务器日志写一个消息（它建议增加 max_wal_size 的值）。				现存
`max_wal_size`	整数	重载生效	`1 GiB`	101 次
在自动检查点期间允许 WAL 增长的最大大小。				现存
`min_wal_size`	整数	重载生效	`80 MiB`	101 次
只要 WAL 磁盘用量保持在这个设置之下，在检查点时旧的 WAL 文件总是被回收以便未来使用，而不是直接被删除。				现存

快速链接