CONFIGURATION PARAMETER开发者选项
zero_damaged_pages
遇到损坏页面头时把内存中的页面清零后继续。
Continues processing past damaged page headers.
布尔 会话（超级用户） 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 布尔bool
- 上下文
- 会话（超级用户）超级用户可在会话内用 SET 修改
- 默认值
off- 分类
- 开发者选项
- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 15 完全一致，下面就是同一段文字。
检测到损坏的页面头通常会导致PostgreSQL报告错误，中止当前事务。 将zero_damaged_pages设置为on会导致系统报告警告，将内存中的损坏页面清零，并继续处理。 这种行为会破坏数据，即损坏页面上的所有行。但是，它确实允许您跳过错误，并从表中可能存在的未损坏页面中检索行。 如果由于硬件或软件错误而发生损坏，这对于恢复数据很有用。通常在放弃从表的损坏页面恢复数据的希望之前，不应将其设置为on。 清零的页面不会强制写入磁盘，因此建议在再次关闭此参数之前重新创建表或索引。默认设置为off。 只有超级用户和具有适当SET权限的用户才能更改此设置。
机制详解
PostgreSQL 检测到损坏页面头时，zero_damaged_pages 会在内存中替换为全零页、发出警告并继续；原页面上的每一行都会从抢救读取中丢失。
零页不会自动强制写盘，因此继续使用该关系会产生不一致行为；抢救后必须重建表或索引。
这是备份与存储恢复手段耗尽后的最后数据提取开关。必须在已保全副本上窄范围使用，并在完成后立即关闭。其 superuser 上下文允许获授权会话修改，无需重启服务器。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
绝不能把 zero_damaged_pages 当作调优或常态可用性设置。应停止写入、保全不可变副本、用尽备份/存储修复、记录预期数据损失、窄范围抢救、重建并验证后才可恢复服务。
-
OLAP分析与批处理
只读分析也不会让 zero_damaged_pages 安全：损坏页面仍会污染结果或结构。只能在可丢弃抢救副本上使用，并明确接受数据丢失。
-
小规格低配实例与开发机
不能因为没有副本就直接启用 zero_damaged_pages。先保全原件并寻找干净备份；该开关可能把可见损坏变成静默丢失。
常见问题
- 限时诊断或恢复任务结束后仍让 zero_damaged_pages 保持启用。
- 在生产数据的唯一副本上进行实验。
- 低估日志、core、临时文件、WAL、CPU 或连接名额放大。
- 把服务器能启动或查询能完成误当作数据与行为正确的证明。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 17 ← 16 仅描述更新
补充说明
Detection of a damaged page header normally causes PostgreSQL to report an error, aborting the current transaction. Setting zero_damaged_pages to true causes the system to instead report a warning, zero out the damaged page, and continue processing. This behavior will destroy data, namely all the rows on the damaged page.Detection of a damaged page header normally causes PostgreSQL to report an error, aborting the current transaction. Setting "zero_damaged_pages" to true causes the system to instead report a warning, zero out the damaged page, and continue processing. This behavior will destroy data, namely all the rows on the damaged page.
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.1 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.2 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.3 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.4 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.5 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 9.6 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 10 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 11 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 12 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 13 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 14 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 15 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 16 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 17 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 18 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 19 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
| 20 沿用 | off |
— |
会话（超级用户） |
布尔 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
allow_in_place_tablespaces |
布尔 | 会话（超级用户） | off |
— | |
| 允许在 pg_tblspc 内直接创建 tablespace，用于测试。 | 现存 | ||||
allow_system_table_mods |
布尔 | 会话（超级用户） | off |
131 次 | |
| 允许修改系统表的结构。 | 现存 | ||||
backtrace_functions |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 当指定函数中发生错误时记录调用栈。 | 现存 | ||||
debug_discard_caches |
整数 | 会话（超级用户） | 0 |
— | |
| 为调试而激进地使系统目录缓存失效。 | 现存 | ||||
debug_io_direct |
字符串 | 重启生效 | 空字符串 |
— | |
| 为指定文件访问使用直接 I/O。 | 现存 | ||||
debug_logical_replication_streaming |
枚举 | 会话 | buffered |
— | |
| 强制大型事务立即流式发送或序列化变更。 | 现存 | ||||
debug_parallel_query |
枚举 | 会话 | off |
— | |
| 为测试而强制规划器使用并行查询节点。 | 现存 | ||||
force_parallel_mode |
枚举 | 会话 | off |
— | |
| 强制使用并行查询设施。 | 于 16 移除 | ||||
ignore_checksum_failure |
布尔 | 会话（超级用户） | off |
— | |
| 校验和失败后仍继续处理。 | 现存 | ||||
ignore_invalid_pages |
布尔 | 重启生效 | off |
— | |
| 恢复遇到无效页面引用后仍继续。 | 现存 | ||||
ignore_system_indexes |
布尔 | 连接时 | off |
— | |
| 读取系统表时忽略系统索引。 | 现存 | ||||
jit_debugging_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向调试器注册 JIT 生成的函数。 | 现存 | ||||
jit_dump_bitcode |
布尔 | 会话（超级用户） | off |
— | |
| 将 LLVM 位码写盘以便调试 JIT。 | 现存 | ||||
jit_expressions |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译表达式。 | 现存 | ||||
jit_profiling_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向 perf 分析器注册 JIT 生成的函数。 | 现存 | ||||
jit_tuple_deforming |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译元组拆解。 | 现存 | ||||
post_auth_delay |
整数 | 连接时 | 0 s |
— | |
| 设置连接认证完成后的调试等待时间。 | 现存 | ||||
pre_auth_delay |
整数 | 重载生效 | 0 s |
— | |
| 设置连接认证开始前的调试等待时间。 | 现存 | ||||
remove_temp_files_after_crash |
布尔 | 重载生效 | on |
— | |
| 控制后端崩溃后是否删除临时文件。 | 现存 | ||||
send_abort_for_crash |
布尔 | 重载生效 | off |
— | |
| 后端崩溃后向其他子进程发送 SIGABRT 而非 SIGQUIT。 | 现存 | ||||
send_abort_for_kill |
布尔 | 重载生效 | off |
— | |
| 终止卡住的子进程时发送 SIGABRT 而非 SIGKILL。 | 现存 | ||||
trace_connection_negotiation |
布尔 | 重启生效 | off |
— | |
| 记录认证前连接握手的详细信息。 | 现存 | ||||
trace_notify |
布尔 | 会话 | off |
— | |
| 为 LISTEN 和 NOTIFY 生成调试输出。 | 现存 | ||||
trace_recovery_messages |
枚举 | 重载生效 | log |
— | |
| 控制恢复相关调试消息的日志级别。 | 于 17 移除 | ||||
trace_sort |
布尔 | 会话 | off |
— | |
| 输出排序操作的资源使用信息。 | 现存 | ||||
wal_consistency_checking |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 设置要执行 WAL 一致性检查的资源管理器。 | 现存 | ||||
zero_damaged_pages |
布尔 | 会话（超级用户） | off |
— | |
| 遇到损坏页面头时把内存中的页面清零后继续。 | 现存 | ||||