CONFIGURATION PARAMETER预写式日志 / 设置

full_page_writes

启用此参数时，PostgreSQL 服务器会在检查点之后首次修改每个磁盘页面时，将该页面的全部内容写入 WAL。

Writes full pages to WAL when first modified after a checkpoint.

布尔重载生效引入 8.1 现存至 20 devel 0 次默认值变更

类型: 布尔bool
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: on
分类: 预写式日志 / 设置
引入版本: 8.1
状态: 现存

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

on 9.0 – 19

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

手册说明

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

启用此参数时，PostgreSQL 服务器会在检查点之后首次修改每个磁盘页面时，将该页面的全部内容写入 WAL。这样做是因为，操作系统崩溃时正在进行的页面写入可能只完成了一部分，导致磁盘页面混有新旧数据。通常存储在 WAL 中的行级变更数据不足以在崩溃恢复时完整还原这样的页面。保存整页镜像能保证正确恢复页面，但会增加必须写入 WAL 的数据量。（由于 WAL 重放总是从检查点开始，只需在检查点之后首次修改每个页面时这样做。因此，减少整页写入开销的一种方法是增大检查点间隔参数。）

关闭此参数可以加快正常操作，但系统故障后可能出现不可恢复的数据损坏或静默数据损坏。风险与关闭 fsync 类似，虽然较小，但也只有在建议关闭 fsync 的相同情形下，才应关闭此参数。

关闭这个选项并不影响用于时间点恢复（PITR）的 WAL 归档使用（见第 25.3 节）。

这个参数只能在 postgresql.conf 文件中或在服务器命令行上设置。默认值是 on。

机制详解

检查点后页面首次修改时将完整页面写入 WAL。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

每次检查点后，数据页第一次修改会把完整页映像写入 WAL，避免撕裂页恢复时拼接新旧扇区。额外 WAL 集中在检查点后并受 wal_compression 影响；除非存储栈提供等价的原子页保证，否则不应关闭。

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

调优建议

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

OLTP在线事务处理

持久生产数据保持 full_page_writes=on。性能问题应从存储延迟、检查点、WAL 压缩和批处理着手，不要用关闭崩溃安全换吞吐。
OLAP分析与批处理

批量装载同样需要可恢复性；用 UNLOGGED/临时数据结构或可重建 staging 明确缩小耐久范围，而不是全局关闭保护。
小规格低配实例与开发机

持久小实例也保持开启。只有数据可随时重建且与生产明确隔离的临时集群，才可在书面接受风险后例外。

常见问题

没有端到端原子页写保证就关闭该参数。
把它增加的 WAL 量误解成每次修改都会记录整页。
忽略检查点之后全页镜像集中出现的 WAL 突发。
误以为 reload 后会追溯保护在 full_page_writes=off 期间已经生成的 WAL。
关闭参数做基准，却没有端到端崩溃、恢复与 torn-page 测试。

演化历史

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

PostgreSQL 8.1 ← 8.0 新增此参数

PostgreSQL 8.1 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.1	—	—	—	`布尔`	—	—	—
8.2	—	—	—	`布尔`	—	—	—
8.3	—	—	—	`布尔`	—	—	—
8.4	—	—	—	`布尔`	—	—	—
9.0	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.1	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.2	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.3	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.4	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.5	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
9.6	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
10	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
11	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
12	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
13	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
14	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
15	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
16	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
17	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
18	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
19	`on`	`—`	`重载生效`	`布尔`	`—`	`—`	`—`
20	—	—	—	`布尔`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Write-Ahead Log 预写式日志 15 个 ↗
设置 15
`commit_delay`	整数	会话（超级用户）	`0`	9.31 次
设置 commit_delay 会在发起 WAL 刷盘之前添加时间延迟。				现存
`commit_siblings`	整数	会话	`5`	9.11 次
执行 commit_delay 延迟前要求的并发活动事务的最小数目。				现存
`fsync`	布尔	重载生效	`on`	—
如果打开这个参数，PostgreSQL 服务器将尝试确保更新被物理地写入到磁盘，做法是发出 fsync() 系统调用或者使用多种等价的方法（见 wal_sync_method）。				现存
`full_page_writes`	布尔	重载生效	`on`	—
启用此参数时，PostgreSQL 服务器会在检查点之后首次修改每个磁盘页面时，将该页面的全部内容写入 WAL。				现存
`synchronous_commit`	枚举	会话	`on`	9.63 次
指定数据库服务器向客户端返回“成功”指示之前，必须完成多少 WAL 处理。				现存
`wal_buffers`	整数	重启生效	`-1 8kB`	9.11 次
用于还未写入磁盘的 WAL 数据的共享内存量。				现存
`wal_compression`	枚举	会话（超级用户）	`off`	151 次
此参数启用使用指定的压缩方法对 WAL 进行压缩。				现存
`wal_init_zero`	布尔	会话（超级用户）	`on`	—
如果设置为 on（默认值），此选项会导致新的 WAL 文件被零填充。				现存
`wal_level`	枚举	重启生效	`replica`	103 次
wal_level 决定多少信息写入到 WAL 中。				现存
`wal_log_hints`	布尔	重启生效	`off`	—
当这个参数为 on 时，PostgreSQL 服务器在检查点之后首次修改页面时把该磁盘页面的整个内容都写入 WAL，即使对所谓的提示位做非关键修改也会这样做。				现存
`wal_recycle`	布尔	会话（超级用户）	`on`	—
如果设置为 on（默认值），此选项通过重命名来回收 WAL 文件，从而避免创建新文件。				现存
`wal_skip_threshold`	整数	会话	`2 MiB`	—
当 wal_level 为 minimal，且事务在创建或重写永久关系后提交时，此设置决定如何持久保存新数据。				现存
`wal_sync_method`	枚举	重载生效	`fdatasync`	8.41 次
用于将 WAL 更新强制写入磁盘的方法。				现存
`wal_writer_delay`	整数	重载生效	`200 ms`	—
指定 WAL 写入器刷写 WAL 的频繁程度，以时间为单位。				现存
`wal_writer_flush_after`	整数	重载生效	`1 MiB (128 × 8kB)`	—
指定 WAL 写入器刷写 WAL 的频繁程度，按数据量衡量。				现存

快速链接