CONFIGURATION PARAMETER锁管理
deadlock_timeout
指定在检查是否发生死锁之前等待锁的时间。
Sets the time to wait on a lock before checking for deadlock.
整数 会话（超级用户） 引入 7.4（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话（超级用户）超级用户可在会话内用 SET 修改
- 默认值
1 s原始值 1000 ms- 取值范围
1 – 2147483647- 分类
- 锁管理
- 引入版本
- 7.4（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定在检查是否发生死锁之前等待锁的时间。检查死锁相对昂贵，因此服务器不会每次等待锁时都运行它。我们乐观地假设在生产应用程序中死锁并不常见，所以在检查死锁之前只是等待一段时间。增加此值会减少在不必要的死锁检查中浪费的时间，但会减慢实际死锁错误的报告速度。如果未指定单位，则将其视为毫秒。默认值为一秒（1s），这可能是你在实践中想要的最小值。在负载较重的服务器上，你可能希望提高它。理想情况下，设置应超过你的典型事务时间，以提高在等待者决定检查死锁之前释放锁的几率。只有超级用户和具有适当 SET 权限的用户才能更改此设置。
当 log_lock_waits 被设置时，这个参数也决定发出关于锁等待的日志之前等待的时间量。如果你想调查锁延迟，你可能希望设置一个比正常的 deadlock_timeout 小的值。
机制详解
设置等待锁多久后开始检查死锁。超级用户或获授 SET 权限的角色可在相应的会话或配置作用域中修改它。
PostgreSQL 等待到该时长才运行成本较高的死锁检测器。启用 log_lock_waits 时，同一时长也决定锁等待日志，因此调低会加快诊断与死锁响应，但普通争用中会增加检测次数。
应把 deadlock_timeout 与 log_lock_waits、lock_timeout、max_locks_per_transaction 一起监控和变更。先在对应角色与真实负载上验证，再按其 superuser context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
从锁等待日志、涉及对象数量和并发上界校准 deadlock_timeout；先修复过长事务与访问顺序，再增加共享内存或改变检测粒度。
-
OLAP分析与批处理
分区查询、批量 DDL 与 SERIALIZABLE 报表可能触及大量对象；用最坏计划验证，而不是只看平均事务。
-
小规格低配实例与开发机
保持默认通常足够。若提高启动时锁表参数，要同时核算 max_connections、prepared transactions 与备库一致性。
常见问题
- 把平均共享内存规划值当成单事务硬上限。
- 提高参数却不核算连接数与预备事务带来的乘数。
- 只扩容锁表，不修复长事务、对象访问顺序或分区爆炸。
- 忽略备库必须具备兼容的启动时锁容量。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 9.2 ← 9.1 属性变更
上下文
重载生效会话（超级用户） -
PostgreSQL 9.1 ← 9.0 属性变更
最大值
21474832147483647
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 7.4 | — | — | — | 整数 |
— | — | — |
| 8.0 | — | — | — | 整数 |
— | — | — |
| 8.1 | — | — | — | 整数 |
— | — | — |
| 8.2 | — | — | — | 整数 |
— | — | — |
| 8.3 | — | — | — | 整数 |
— | — | — |
| 8.4 | — | — | — | 整数 |
— | — | — |
| 9.0 | 1 s |
ms |
重载生效 |
整数 |
1 |
2147483 |
— |
| 9.1 | 1 s |
ms |
重载生效 |
整数 |
1 |
2147483647 |
— |
| 9.2 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 9.3 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 9.4 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 9.5 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 9.6 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 10 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 11 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 12 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 13 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 14 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 15 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 16 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 17 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 18 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 19 | 1 s |
ms |
会话（超级用户） |
整数 |
1 |
2147483647 |
— |
| 20 | — | — | — | 整数 |
— | — | — |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
deadlock_timeout |
整数 | 会话（超级用户） | 1 s |
9.22 次 | |
| 指定在检查是否发生死锁之前等待锁的时间。 | 现存 | ||||
max_locks_per_transaction |
整数 | 重启生效 | 64 |
191 次 | |
| 共享锁表为每个服务器进程或预备事务预留可容纳 max_locks_per_transaction 个对象（例如表）的空间；因此，在任何时刻可被锁住的不同对象数都不能超过总容量。 | 现存 | ||||
max_pred_locks_per_page |
整数 | 重载生效 | 2 |
— | |
| 这个参数控制在谓词锁被提升为覆盖整个页面之前，可以对单个页面中的多少行加谓词锁。 | 现存 | ||||
max_pred_locks_per_relation |
整数 | 重载生效 | -2 |
— | |
| 这个参数控制在谓词锁被提升为覆盖整个关系之前，可以对单个关系中的多少页面或元组加谓词锁。 | 现存 | ||||
max_pred_locks_per_transaction |
整数 | 重启生效 | 64 |
— | |
| 共享谓词锁表为每个服务器进程或预备事务预留可容纳 max_pred_locks_per_transaction 个对象（例如表）的空间；因此，在任何时刻可被锁住的不同对象数都不能超过总容量。 | 现存 | ||||