CONFIGURATION PARAMETER复制 / 发送服务器

idle_replication_slot_timeout

使保持空闲状态（未被复制连接使用）超过此持续时间的复制槽失效。

Sets the duration a replication slot can remain idle before it is invalidated.

整数重载生效引入 18 现存至 20 devel 0 次默认值变更

类型: 整数integer
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: 0 s原始值 0 s
取值范围: 0 – 2147483647
分类: 复制 / 发送服务器
引入版本: 18
状态: 现存

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

版本轨迹

PostgreSQL 18 新增此参数。

默认值变迁

0 s 18 – 19

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

手册说明

PostgreSQL 18.7 手册 · 19.6 复制本站手册官方原文

使保持空闲状态（未被复制连接使用）超过此持续时间的复制槽失效。如果指定值时没有单位，则以秒为单位。零值（默认值）将禁用空闲超时失效机制。该参数只能在 postgresql.conf 文件中或服务器命令行上设置。

由于空闲超时导致的槽失效会在检查点期间发生。由于检查点每隔 checkpoint_timeout 触发一次，因此从 idle_replication_slot_timeout 超时到下一个检查点使槽失效之间可能会有一些延迟。若要避免这种延迟，用户可以强制执行检查点，以便及时使不活动的槽失效。槽的不活动时间根据其 pg_replication_slots.inactive_since 值计算。

请注意，空闲超时失效机制不适用于不保留 WAL 的槽，也不适用于正在从主库同步的备库上的槽（即 pg_replication_slots.synced 值为 true 的备库槽）。已同步的槽总是被视为空闲，因为它们不会执行逻辑解码来生成变更。

机制详解

设置复制槽保持空闲多久后失效。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

PostgreSQL 18 从 pg_replication_slots.inactive_since 计算空闲时间，并在超过阈值后的检查点使合格槽失效。零禁用策略；不保留 WAL 的槽与从主库同步来的备库槽不适用。

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

调优建议

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

OLTP在线事务处理

按主备拓扑、故障切换角色、复制槽/订阅数量与断连余量规划 idle_replication_slot_timeout；上线前验证主库写延迟、备库重放和磁盘保留的最坏情况。
OLAP分析与批处理

读备库与逻辑订阅常有长查询或大事务，应给重放/应用留明确上界，并监控延迟、worker 饱和、槽 restart_lsn 与冲突取消。
小规格低配实例与开发机

只配置真实需要的复制能力。少量节点也应设置有界超时与槽生命周期，不要用无限保留换取表面稳定。

常见问题

期待时长一到立刻失效，而不是等后续检查点。
误以为同步来的备库槽也适用。
自动失效前没有订阅者重建 runbook。
在错误的主库、备库、发送端或订阅端角色上修改。
只看字节/时间配置，不监控真实复制延迟、槽位置与 worker 状态。

演化历史

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

PostgreSQL 19 ← 18 仅描述更新

补充说明 （无） 0 disables the timeout.
PostgreSQL 18 ← 17 新增此参数

PostgreSQL 18 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
18	`0 s`	`s`	`重载生效`	`整数`	`0`	`2147483647`	`—`
19	`0 s`	`s`	`重载生效`	`整数`	`0`	`2147483647`	`—`
20	—	—	—	`整数`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Replication 复制 12 个 ↗
发送服务器 12
`idle_replication_slot_timeout`	整数	重载生效	`0 s`	—
使保持空闲状态（未被复制连接使用）超过此持续时间的复制槽失效。				现存
`max_repack_replication_slots`	整数		—	—
指定可供 REPACK 命令使用的复制槽最大数量。				现存
`max_replication_slots`	整数	重启生效	`10`	102 次
指定服务器可以支持的复制槽（见第 26.2.6 节）最大数量。				现存
`max_slot_wal_keep_size`	整数	重载生效	`-1 MB`	—
指定检查点时复制槽允许在 pg_wal 目录中保留的 WAL 文件最大总量。				现存
`max_wal_senders`	整数	重启生效	`10`	103 次
指定来自备库或流式基础备份客户端的最大并发连接数（即同时运行的 WAL 发送进程的最大数量）。				现存
`output_plugin_libraries`	字符串	会话（超级用户）	`pgoutput, test_decoding`	—
列出安装在 dynamic_library_path 所指定位置中、同时也受信任、可供复制客户端用作逻辑输出插件的库。				现存
`replication_timeout`	整数	重载生效	`1 min`	—
终止不活动时间超过指定毫秒数的复制连接。				于 9.3 移除
`track_commit_timestamp`	布尔	重启生效	`off`	—
记录事务的提交时间。				现存
`wal_keep_segments`	整数	重载生效	`0`	—
指定在 pg_wal 目录中保留的过去日志文件段的最小数量，以便备库可能需要获取它们来进行流复制。				于 13 移除
`wal_keep_size`	整数	重载生效	`0 B`	—
指定在 pg_wal 目录中保留的旧 WAL 文件的最小总量，以便备库需要时获取这些文件进行流复制。				现存
`wal_sender_shutdown_timeout`	整数		—	—
指定服务器在关闭期间等待所有 WAL 数据复制到接收端的最长时间。				现存
`wal_sender_timeout`	整数	会话	`1 min`	121 次
终止非活动时间超过此值的复制连接。				现存

快速链接