CONFIGURATION PARAMETER清理 / 冻结
vacuum_failsafe_age
设置 VACUUM 为避免事务 ID 回卷停机而进入保护模式的年龄。
Age at which VACUUM should trigger failsafe to avoid a wraparound outage.
整数 会话 引入 14 现存至 20 devel 0 次默认值变更
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 14 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定表的pg_class.relfrozenxid字段在VACUUM采取特别措施以避免系统范围事务 ID 回卷失败之前所允许达到的最大年龄（以事务计）。这是VACUUM的最后防线。失效保护通常会在防止事务 ID 回卷的 autovacuum 已经运行了一段时间后触发，但也有可能在任何VACUUM期间触发。
当失效保护被触发时，将不再应用任何有效的基于成本的延迟，并且会跳过进一步的非关键维护任务（例如索引 vacuum）。
默认值为 16 亿个事务。尽管用户可以将该值设置为 0 到 21 亿之间的任意值，VACUUM会悄悄将有效值调整为不低于autovacuum_freeze_max_age的 105%。
机制详解
设置 VACUUM 为避免事务 ID 回卷停机而进入保护模式的年龄。它可在会话级修改，因此不同会话可能采用不同的行为。
年龄达到 failsafe 后，正在运行的 VACUUM 优先尽快推进冻结边界，会停止成本延迟并跳过部分非必要工作（包括索引清理与表尾截断）。这是避免回卷停机的最后保护，不是日常性能模式。
应把 vacuum_failsafe_age 与 autovacuum_freeze_max_age、vacuum_freeze_min_age、vacuum_freeze_table_age 一起监控和变更。先在对应角色与真实负载上验证，再按其 user context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
以全库最大 XID/MXID 年龄、最旧表和清理完成速率校准 vacuum_failsafe_age；优先消除长事务、失效槽和被阻塞 worker，绝不能靠提高年龄掩盖积压。
-
OLAP分析与批处理
在批量窗口主动 VACUUM (FREEZE) 新装载/静态分区，并给全表扫描留 I/O 时间；年龄预算按峰值事务速率而不是墙钟经验换算。
-
小规格低配实例与开发机
保持上游默认通常最安全。容量较小不等于可关闭防回卷维护；监控所有数据库，而不只是当前业务库。
常见问题
- 把 failsafe 当作常态高吞吐 VACUUM 模式。
- 紧急结束后忽略被跳过的索引清理。
- 提高年龄以压制维护失败的证据。
- 只改全局值，忽略表级 storage parameter 覆盖。
- 把 reltuples 与累计变更统计当作精确实时计数。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
分类
Client Connection Defaults / Statement BehaviorVacuuming / Freezing -
PostgreSQL 14 ← 13 新增此参数
PostgreSQL 14 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 冻结 7 | |||||
vacuum_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免事务 ID 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_freeze_min_age |
整数 | 会话 | 50000000 |
— | |
| 设置 VACUUM 冻结表行所需的最小年龄。 | 现存 | ||||
vacuum_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结元组而扫描整张表的年龄。 | 现存 | ||||
vacuum_max_eager_freeze_failure_rate |
浮点 | 会话 | 0.03 |
— | |
| 设置 VACUUM 在关闭积极冻结扫描前，允许扫描但未能冻结的页面比例。 | 现存 | ||||
vacuum_multixact_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免 MultiXact 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_multixact_freeze_min_age |
整数 | 会话 | 5000000 |
— | |
| 设置 VACUUM 冻结表行中 MultiXactId 所需的最小年龄。 | 现存 | ||||
vacuum_multixact_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结 MultiXact 而扫描整张表的年龄。 | 现存 | ||||