CONFIGURATION PARAMETER预写式日志 / 设置

wal_buffers

设置共享内存中用于 WAL 的磁盘页缓冲区数量。

Sets the number of disk-page buffers in shared memory for WAL.

整数重启生效引入 9.0（基线）现存至 20 devel 1 次默认值变更

类型: 整数integer
上下文: 重启生效只能在服务器启动时设置，修改后需要重启
默认值: -1 8kB原始值 -1 8kB
取值范围: -1 – 262143
分类: 预写式日志 / 设置
引入版本: 9.0（基线）
状态: 现存

PostgreSQL 18 手册官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

64 KiB (8 × 8kB) 9.0 -1 8kB 9.1 – 20

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

手册说明

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

用于还未写入磁盘的 WAL 数据的共享内存量。默认值 -1 选择等于shared_buffers的 1/32 的尺寸（大约3%），但是不小于64kB也不大于 WAL 段的尺寸（通常为16MB）。如果自动的选择太大或太小可以手工设置该值，但是任何小于32kB的正值都将被当作32kB。如果指定值时没有单位，则以WAL块作为单位，即为 XLOG_BLCKSZ 字节，通常为8kB。这个参数只能在服务器启动时设置。

在每次事务提交时，WAL 缓冲区的内容被写出到磁盘，因此极大的值不可能提供显著的收益。不过，把这个值设置为几个兆字节可以在一个繁忙的服务器（其中很多客户端会在同一时间提交）上提高写性能。由默认设置 -1 选择的自动调节将在大部分情况下得到合理的结果。

机制详解

设置共享内存中用于 WAL 的磁盘页缓冲区数量。该值在服务器启动时固定，修改后必须重启。

自动值 -1 选择约 shared_buffers 的 1/32，并受最低值与一个 WAL 段上限约束。缓冲区吸收写出前的 WAL；过小会在突发中增加 WALWrite 压力，过大则占启动共享内存且不能替代持久化刷写。

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

调优建议

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

OLTP在线事务处理

先保证耐久性与恢复目标，再以 WAL 生成速率、刷写延迟、检查点和 pg_wal 峰值调 wal_buffers；每次改动都做崩溃/恢复与归档监控验证。
OLAP分析与批处理

按批量装载峰值规划 WAL、归档带宽和恢复 I/O；需要降低峰值时应协调装载节奏与检查点，而不是牺牲恢复链。
小规格低配实例与开发机

从安全默认开始，按有限磁盘容量设置明确告警；不要仅为节省少量 I/O 就关闭耐久性或破坏恢复链。

常见问题

把 -1 读成负分配，而不是自动尺寸。
忘记自动值依据 shared_buffers 计算，并以一个 WAL 段为上限。
把未带单位的正值读成字节，而不是 WAL 块；过小正值会提升到最低值。
没有 WALInsert/WALWrite 压力证据就手工分配很大缓冲。
误以为更多 WAL buffer 能替代持久刷盘或改善受存储限制的 WALSync。

演化历史

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

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 18 ← 17 仅描述更新

补充说明 Specify -1 to have this value determined as a fraction of shared_buffers. -1 means use a fraction of "shared_buffers".
PostgreSQL 17 ← 16 仅描述更新

补充说明 （无） Specify -1 to have this value determined as a fraction of shared_buffers.
PostgreSQL 9.1 ← 9.0 默认值变更

默认值 64 KiB (8 × 8kB) -1 8kB 最小值 4 -1

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.0	`64 KiB (8 × 8kB)`	`8kB`	`重启生效`	`整数`	`4`	`262143`	`—`
9.1	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
9.2	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
9.3	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
9.4	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
9.5	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
9.6	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
10	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
11	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
12	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
13	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
14	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
15	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
16	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
17	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
18	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
19	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`
20 沿用	`-1 8kB`	`8kB`	`重启生效`	`整数`	`-1`	`262143`	`—`

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Write-Ahead Log 预写式日志 15 个 ↗
设置 15
`commit_delay`	整数	会话（超级用户）	`0`	9.31 次
设置事务提交与将 WAL 刷入磁盘之间的延迟（微秒）。				现存
`commit_siblings`	整数	会话	`5`	9.11 次
设置启用 commit_delay 前所需的并发活动事务最低数量。				现存
`fsync`	布尔	重载生效	`on`	—
强制将更新同步到磁盘。				现存
`full_page_writes`	布尔	重载生效	`on`	—
检查点后页面首次修改时将完整页面写入 WAL。				现存
`synchronous_commit`	枚举	会话	`on`	9.63 次
设置当前事务提交时使用的同步级别。				现存
`wal_buffers`	整数	重启生效	`-1 8kB`	9.11 次
设置共享内存中用于 WAL 的磁盘页缓冲区数量。				现存
`wal_compression`	枚举	会话（超级用户）	`off`	151 次
使用指定方法压缩写入 WAL 的整页映像。				现存
`wal_init_zero`	布尔	会话（超级用户）	`on`	—
新 WAL 文件首次使用前先写零。				现存
`wal_level`	枚举	重启生效	`replica`	103 次
设置写入 WAL 的信息级别。				现存
`wal_log_hints`	布尔	重启生效	`off`	—
页面在检查点后首次发生非关键修改时也将完整页面写入 WAL。				现存
`wal_recycle`	布尔	会话（超级用户）	`on`	—
通过重命名复用 WAL 文件。				现存
`wal_skip_threshold`	整数	会话	`2 MiB`	—
设置用 fsync 新文件代替写 WAL 的最小文件规模。				现存
`wal_sync_method`	枚举	重载生效	`fdatasync`	—
选择将 WAL 更新强制写入磁盘的方法。				现存
`wal_writer_delay`	整数	重载生效	`200 ms`	—
设置 WAL writer 两次刷写之间的时间。				现存
`wal_writer_flush_after`	整数	重载生效	`1 MiB (128 × 8kB)`	—
设置触发 WAL writer 刷盘的写出 WAL 数量。				现存

快速链接