Debian系统升级PostgreSQL版本指南

一、升级前准备

1. 备份数据库

升级前必须备份所有关键数据，防止操作失误导致数据丢失。推荐使用pg_dumpall备份所有数据库（包括用户、权限等信息）：

sudo -u postgres pg_dumpall -f /var/backups/postgresql_full_backup_$(date +%F).sql

或使用pg_dump备份单个数据库：

sudo -u postgres pg_dump -d your_database_name -f /var/backups/your_database_backup.sql

2. 检查当前PostgreSQL版本

确认当前系统安装的PostgreSQL版本，为后续操作提供依据：

psql --version
# 示例输出：psql (PostgreSQL) 14.10 (Debian 14.10-1.pgdg120+1)

3. 更新系统包列表

确保系统软件包为最新状态，避免依赖冲突：

sudo apt update && sudo apt upgrade -y

二、添加PostgreSQL官方APT仓库（可选但推荐）

Debian官方仓库中的PostgreSQL版本可能滞后，建议添加官方PGDG（PostgreSQL Global Development Group）仓库以获取最新稳定版。

1. 创建PGDG仓库文件

echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list

（注：$(lsb_release -cs)会自动替换为当前Debian版本代号，如Debian 12为bookworm）

2. 导入PGDG GPG密钥

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /usr/share/keyrings/postgresql-archive-keyring.gpg

（新版Debian建议使用gpg --dearmor替代已弃用的apt-key add）

3. 更新包列表

sudo apt update

三、执行升级操作

1. 安装目标版本PostgreSQL

通过APT安装所需版本的PostgreSQL（将替换为目标版本，如15）：

sudo apt install postgresql-

安装完成后，系统会自动保留旧版本服务，新旧版本可共存。

2. 停止旧版本PostgreSQL服务

sudo systemctl stop postgresql@-main

（如旧版本为14，则替换为postgresql@14-main）

3. 使用`pg_upgrade`迁移数据

pg_upgrade是PostgreSQL官方提供的数据迁移工具，支持快速升级（保留原数据文件）。

（1）确认新旧版本路径

# 查找旧版本数据目录（默认路径）
ls /var/lib/postgresql/
# 示例输出：14/main

# 查找新版本可执行文件路径
ls /usr/lib/postgresql/
# 示例输出：15/bin/pg_upgrade

（2）执行升级命令

sudo /usr/lib/postgresql//bin/pg_upgrade \
  --old-datadir=/var/lib/postgresql//main \
  --new-datadir=/var/lib/postgresql//main \
  --old-bindir=/usr/lib/postgresql//bin \
  --new-bindir=/usr/lib/postgresql//bin \
  --check  # 先检查兼容性（无数据修改）

若--check通过，移除--check参数正式执行升级：

sudo /usr/lib/postgresql//bin/pg_upgrade \
  --old-datadir=/var/lib/postgresql//main \
  --new-datadir=/var/lib/postgresql//main \
  --old-bindir=/usr/lib/postgresql//bin \
  --new-bindir=/usr/lib/postgresql//bin

4. 重启PostgreSQL服务

sudo systemctl daemon-reload
sudo systemctl start postgresql@-main
sudo systemctl enable postgresql@-main  # 设置开机自启

5. 验证升级结果

psql --version  # 确认版本已更新
sudo -u postgres psql -c "SELECT version();"  # 登录数据库验证

四、清理旧版本（可选）

升级成功后，可删除旧版本以释放磁盘空间：

sudo apt remove --purge postgresql-
sudo rm -rf /var/lib/postgresql/

注意事项

版本兼容性：确保目标版本与旧版本兼容（如14→15为小版本升级，12→15为大版本升级，需额外处理）。
依赖问题：若遇到依赖冲突，可使用sudo apt --fix-broken install修复。
日志检查：升级过程中查看日志（/var/log/postgresql/postgresql--main.log）排查错误。
大版本升级：若从12升级到15等跨主版本，需先使用pg_dumpall备份所有数据库，再按上述步骤操作（小版本升级可直接用pg_upgrade）。

以上就是关于“Debian系统如何升级PostgreSQL版本”的相关介绍，筋斗云是国内较早的云主机应用的服务商，拥有10余年行业经验，提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩，主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复；电子化备案，提交快速，专业团队7×24小时服务支持！

简单好用、高性价比云服务器租用链接：https://www.jindouyun.cn/product/cvm