如何解决PostgreSQL中CATALOG_VERSION_NO版本冲突且不丢失数据？

一、解决15.x内部CATALOG_VERSION_NO不匹配问题 #

你的15.4集群出现catalog版本冲突，本质是服务器二进制版本与集群初始化版本不匹配：pg_control记录的202307071是PostgreSQL 15.4的catalog版本，而服务器编译版本的202209061属于更早的15.x分支版本（如15.1）。解决步骤：

• 停止当前运行的PostgreSQL服务：

  pg_ctl stop -D /你的集群数据目录 -m fast
  

• 卸载当前错误的PostgreSQL二进制包，安装与集群初始化版本完全一致的15.4官方包，确保服务器编译版本的catalog号为202307071
• 使用正确的15.4二进制文件启动服务：

  pg_ctl start -D /你的集群数据目录
  

• 后续小版本升级（如15.4→15.5）必须通过官方支持的方式：包管理器自动升级（apt/yum）或使用pg_upgrade，禁止直接替换二进制文件。

二、从15.x升级到16.0的正确流程 #

直接修改PG_VERSION文件会破坏元数据一致性，引发不可逆错误。正确的无数据丢失升级步骤：

1. 确保当前15.x集群处于对应分支的最新版本（如15.4），并完成全量备份：

   pg_dumpall -f /备份路径/full_backup.sql
   

2. 安装PostgreSQL 16.0官方二进制包，不要启动16版本的服务
3. 停止15.4的PostgreSQL服务
4. 创建16版本的空数据目录（若包管理器未自动创建）：

   initdb -D /16版本数据目录 -U postgres
   

5. 运行pg_upgrade完成升级，替换命令中的路径为实际路径：

   pg_upgrade -b /15.x二进制目录 -B /16.0二进制目录 -d /15.x数据目录 -D /16.0数据目录
   

6. 按照pg_upgrade输出的提示，更新pg_hba.conf等配置文件，启动16.0服务：

   pg_ctl start -D /16版本数据目录
   

7. 运行官方提供的统计信息优化脚本：

   ./analyze_new_cluster.sh
   

8. 验证所有数据正常访问后，再删除旧的15.x集群文件和二进制包。

关键注意事项 #

• 操作前必须完成全量备份，任何升级操作都存在风险
• 禁止手动修改PG_VERSION、pg_control等核心元数据文件
• 始终使用官方或信任的包源获取PostgreSQL二进制包，避免版本混乱

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