AWS RDS PostgreSQL多版本升级失败求助：pg_upgrade无法完成

前置排查步骤 #

• 手动执行pg_upgrade --check命令，这个命令会直接输出集群无法升级的具体原因（比如扩展不兼容、权限问题、未清理的事务残留等），比控制台日志的模糊提示更有用。
• 用pg_controldata确认集群状态：如果是离线升级，必须确保集群是正常关闭的；如果是在线升级，要检查有没有未完成的备份任务、残留的无效流复制槽。
• 检查扩展兼容性：执行SELECT extname, extversion FROM pg_extension;列出所有已装扩展，逐个确认这些扩展在目标PostgreSQL版本中是否支持——很多第三方扩展（比如旧版pg_stat_statements）需要先单独升级到兼容目标版本的版本，才能进行集群升级。

常见问题修复 #

• 清理无效复制槽：从生产同步的集群常残留无用的复制槽，执行SELECT * FROM pg_replication_slots;查看，无效的槽用SELECT pg_drop_replication_slot('slot_name');删除。
• 修复系统表一致性：关闭集群后执行pg_checksdb检查系统表是否有损坏或不一致，根据输出提示修复问题。
• 更新配置参数：检查postgresql.conf里的参数，有些旧版本的参数在新版本中被移除或改名（比如shared_preload_libraries里的旧扩展名称），先调整配置再尝试升级。

升级操作优化 #

• 分阶段升级：直接跨大版本（比如14→17）容易出问题，建议按官方支持的路径分阶段升级：14.15→15.10→16.6→17.2，每一步完成后验证集群正常，再进行下一步。
• 手动执行升级流程：如果自动升级无效，试试手动跑pg_upgrade：
  1. 关闭旧版本PostgreSQL服务
  2. 用新版本的initdb初始化空集群：initdb -D /path/to/new/data
  3. 预检查：pg_upgrade -b /path/to/old/bin -B /path/to/new/bin -d /path/to/old/data -D /path/to/new/data -c
  4. 预检查通过后去掉-c执行正式升级
  5. 升级完成后运行analyze_new_cluster.sh更新统计信息，再启动新版本服务

内容的提问来源于stack exchange，提问作者TheBoi