↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / 配置参数 / 错误处理

CONFIGURATION PARAMETER错误处理

recovery_init_sync_method

当设置为 fsync，也就是默认值，PostgreSQL 将在崩溃恢复开始之前递归地打开并同步数据目录中的所有文件。

Sets the method for synchronizing the data directory before crash recovery.

枚举 重载生效 引入 14 现存至 20 devel 0 次默认值变更

类型
枚举enum
上下文
重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值
fsync
枚举值
fsync, syncfs
分类
错误处理
引入版本
14
状态
现存

PostgreSQL 18.7 手册 官方文档 引入提交 61752afb26

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

fsync 14 – 19

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

手册说明

PostgreSQL 18.7 手册 · 19.14 错误处理 本站手册 官方原文

当设置为 fsync，也就是默认值，PostgreSQL 将在崩溃恢复开始之前递归地打开并同步数据目录中的所有文件。对文件的搜索将遵循 WAL 目录和每个配置表空间的符号链接（而不是任何其他符号链接）。这是为了确保在重放更改之前，所有 WAL 和数据文件都持久地存储在磁盘上。这适用于每次启动未正常关闭的数据库集簇时，包括由 pg_basebackup 创建的副本。

在 Linux 上，可以用 syncfs 代替，请求操作系统来同步数据目录、WAL 文件和各个表空间所在的文件系统（但不是通过符号链接可访问到的任何其他文件系统）。这可能比 fsync 设置快得多，因为它不需要逐个打开每个文件。另一方面，如果一个文件系统是被其他需要修改大量文件的应用程序共享的，它可能会慢一些，因为这些文件也将写入磁盘。此外，在 5.8 之前的 Linux 版本中，向磁盘写入数据时遇到的 I/O 错误可能不会报告给 PostgreSQL，相关的错误消息可能只出现在内核日志中。

这个参数只能在 postgresql.conf 文件中或者服务器命令行中设置。

机制详解

设置崩溃恢复前同步数据目录的方法。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

它定义故障发生后的服务器策略；选择会影响可用性与正确性边界。外部 supervisor、存储错误语义和恢复演练必须与该策略一致。

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

调优建议

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

  • OLTP在线事务处理

    根据故障模型与实际观测决定是否修改 recovery_init_sync_method；先做会话/测试环境验证，再按 context 安全部署并保留回滚值。

  • OLAP分析与批处理

    在长查询、批任务和峰值并发下单独验证，避免把 OLTP 经验直接套用到分析节点。

  • 小规格低配实例与开发机

    没有明确问题就保持默认；小规格环境更应避免以全局兼容性或故障策略换取微小收益。

常见问题

  • 把 recovery_init_sync_method 的启动默认值误当成当前有效值。
  • 忽略 sighup context 对生效时机的约束。
  • 一次改变多个联动参数，无法归因结果。
  • 未在真实故障或负载边界上验证就全局发布。

演化历史

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

  1. PostgreSQL 14 ← 13 新增此参数

    PostgreSQL 14 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
14 fsync — 重载生效 枚举 — — fsync, syncfs
15 fsync — 重载生效 枚举 — — fsync, syncfs
16 fsync — 重载生效 枚举 — — fsync, syncfs
17 fsync — 重载生效 枚举 — — fsync, syncfs
18 fsync — 重载生效 枚举 — — fsync, syncfs
19 fsync — 重载生效 枚举 — — fsync, syncfs
20 — — — 枚举 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Error Handling 错误处理 4 个 ↗
data_sync_retry 布尔 重启生效 off —
当设置为 off（默认值）时，PostgreSQL 在将修改后的数据文件刷盘到文件系统失败时，将引发 PANIC 级错误。 现存
exit_on_error 布尔 会话 off —
如果为开（on），任何错误将中止当前会话。 现存
recovery_init_sync_method 枚举 重载生效 fsync —
当设置为 fsync，也就是默认值，PostgreSQL 将在崩溃恢复开始之前递归地打开并同步数据目录中的所有文件。 现存
restart_after_crash 布尔 重载生效 on —
当设置为 on（默认值）时，PostgreSQL 将在一次后端崩溃后自动重新初始化。 现存