CONFIGURATION PARAMETER错误处理
recovery_init_sync_method
设置崩溃恢复前同步数据目录的方法。
Sets the method for synchronizing the data directory before crash recovery.
枚举 重载生效 引入 14 现存至 20 devel 0 次默认值变更
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 14 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 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 对生效时机的约束。
- 一次改变多个联动参数，无法归因结果。
- 未在真实故障或负载边界上验证就全局发布。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 14 ← 13 新增此参数
PostgreSQL 14 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
data_sync_retry |
布尔 | 重启生效 | off |
— | |
| 设置数据文件同步失败后是否继续运行。 | 现存 | ||||
exit_on_error |
布尔 | 会话 | off |
— | |
| 发生任何错误后终止会话。 | 现存 | ||||
recovery_init_sync_method |
枚举 | 重载生效 | fsync |
— | |
| 设置崩溃恢复前同步数据目录的方法。 | 现存 | ||||
restart_after_crash |
布尔 | 重载生效 | on |
— | |
| 后端崩溃后重新初始化服务器。 | 现存 | ||||