PostgreSQL 14停止维护前怎么升级：兼容、恢复与锁等待证据
PostgreSQL 14 将于 2026 年 11 月 12 日停止接收修复。本页提供升级准备清单，以及经过 14-18 隔离验证的锁等待只读脚本。
先盘点版本、扩展、驱动、复制、备份恢复与关键SQL，再在隔离环境演练目标版本；日常锁等待仍以脱敏快照形成候选链，不自动终止会话。
适用对象
- 可下载SQL已在PostgreSQL 14.20、15.18、16.14、17.10与18.4隔离合成锁等待中通过。
- 先固定问题时间窗、数据库、应用和业务影响，再保存等待进程、阻塞进程、事务与查询起点。
- `pg_locks`展示当前锁状态快照，需要结合`pg_stat_activity`、时间窗口和应用行为判断。
- 候选头部阻塞者只是需要继续核验的对象；一次快照不能说明事务用途、持续时间或终止后的回滚影响。
- 工作表只保存脱敏标识和只读摘要；不得仅凭一次快照自动终止会话或修改事务。
- PostgreSQL 14将在2026年11月12日停止接收修复；升级完成必须同时通过服务、数据、应用、性能和责任验收。
PostgreSQL 14停止维护前，先取得四类升级证据
官方维护边界不是营销倒计时，也不代表生产可以未经演练直接切换。
PostgreSQL版本策略显示14系列将在2026年11月12日停止接收修复。企业应先确认所有主库、只读节点、灾备和临时环境的版本与角色，再盘点扩展、FDW、驱动、连接池、复制槽、归档、备份恢复、关键SQL和容量水位。
目标版本的选择不能只看新功能。应使用脱敏副本、隔离恢复环境或可回放合成负载，验证扩展与驱动兼容、恢复与复制重建耗时、数据对账、关键SQL计划、监控告警和失败回退；一次演练成功也不能替代生产审批。
| 问题 | 需要的证据 | 缺失时停止什么 |
|---|---|---|
| 实际运行哪些版本 | 节点、角色、版本、补丁和生命周期清单 | 停止目标版本和窗口判断 |
| 应用依赖哪些行为 | 扩展、FDW、驱动、连接池、作业和排序规则 | 停止兼容性结论 |
| 升级失败如何恢复 | 已验证备份、恢复耗时、WAL/归档和旧集群保留 | 停止生产切换 |
| 什么叫升级完成 | 数据、应用、性能、复制、监控和签收标准 | 停止关闭回退窗口 |
怎样用只读证据找到锁等待链
把锁快照与活动会话、时间窗口和应用行为关联起来，而不是只盯住一个 pid。
先为等待进程记录`wait_event_type`、`wait_event`、事务起点、查询起点和脱敏query_id，再核对它正在等待的锁类型、对象以及候选阻塞进程。所有时间都要带时区并落在同一问题窗口。
应用名称、发布窗口和业务影响可以说明为什么这个等待重要；未受影响的数据库、应用或时间段则是反证。二者都应保留，防止把偶发快照写成确定根因。
| 证据组 | 填写内容 | 可以帮助判断 | 不能单独证明 |
|---|---|---|---|
| 问题窗口 | 版本、时区、开始/结束、数据库、业务影响 | 现象和证据是否处于同一窗口 | 不能定位具体阻塞者 |
| 活动会话 | 脱敏pid、状态、事务/查询起点、等待事件 | 哪些进程正在等待以及持续边界 | 等待不一定来自锁 |
| 锁与对象 | 阻塞pid、锁类型、relation、granted | 候选等待关系和对象范围 | 一次快照不能证明长期链路 |
| 应用与变更 | 脱敏应用、发布、批处理、连接行为 | 是否存在共同时间线 | 时间相关不等于因果 |
| 反证与结论 | 未受影响范围、替代解释、证据缺口 | 结论是否经得住反向核对 | 不能自动授权生产动作 |
从等待进程到候选头部阻塞者的五步复核
每一步都只记录最小必要信息。若权限不足或快照已经消失，应标记“缺失”而不是补写推测；若需要增加采集、取消查询、终止进程或修改事务，应进入单独的风险评审。
PostgreSQL锁等待只读复核
- 01
01
固定窗口
记录版本、时区、数据库、应用、现象和业务影响。
- 02
02
记录等待者
保存脱敏pid、状态、事务/查询起点和等待事件。
- 03
03
关联锁快照
记录锁类型、对象、granted和候选阻塞pid。
- 04
04
核对应用行为
对照发布、批处理、连接管理和未受影响范围。
- 05
05
人工决定
写明候选头部阻塞者、反证、缺口和下一步权限。
一次快照只用于形成候选解释，不自动触发取消查询、终止进程、提交或回滚事务。
下载PostgreSQL锁等待只读SQL与证据表
SQL只输出快照内`wait-N`与`block-N`代号、等待类型、等待事件、状态、事务年龄区间和阻塞者数量，不输出真实pid、query、库名、用户名、应用名、对象名或地址。CSV可补充问题窗口、业务影响与反证；无权采集的字段写“缺失”或“需授权”。若首轮材料仍无法分级，可进入B-HC固定范围服务。发布后第14天看资料到自查或服务的有效动作，第30天看有效线索，第90天才决定是否调整页面；下载、点击和QA不算商业结果。
本节判断
- 适用PostgreSQL 14-18；13及更早版本、生产和客户环境未验证。
- 缺少`pg_read_all_stats`或等价可见性时返回`insufficient_visibility`，不误写为没有锁等待。
- 记录`pg_locks`与`pg_stat_activity`采集时间，不把不同快照拼成确定链路。
- 同时保存候选头部阻塞者、反证和证据缺口。
- B-HC不包含自动终止会话、修改事务、生产改库或恢复效果承诺。
参考依据
以下来源用于确认市场趋势、政策背景和术语边界；具体落地方案仍以客户的数据范围、权限和交付目标为准。
常见问题
pg_locks看到未授予的锁后是否就能终止阻塞进程？
不能。还要确认阻塞链、事务用途、持续时间、业务责任、回滚影响和审批权限。单次快照只能支持进一步核验。
为什么要同时看pg_stat_activity？
pg_locks描述锁状态，pg_stat_activity补充会话状态、事务和查询起点、等待事件及应用信息。两者结合才能把锁与当前活动关联。
快照已经消失还能得出结论吗？
只能记录现象和已有证据，不能补写确定根因。需要复现或增加采集时，应评估权限、数据敏感性和生产负载后另行授权。