一、升级前前置准备
升级操作前必须完成以下准备，避免数据丢失或业务中断，不要跳过任何一步：
1. 完整备份数据与配置
- 登录宝塔面板后台，点击左侧菜单栏软件商店，切换到「已安装」标签页
- 找到需要升级的目标软件，点击右侧设置，进入「备份」选项卡，点击「创建备份」，将当前软件的配置、数据完整备份
- 生产环境升级额外操作：点击左侧菜单栏「面板设置」→「导出备份」，将整个面板的配置导出，下载到本地留存
- 如果是升级MySQL、PostgreSQL这类核心数据库，额外执行命令导出全量SQL：
mysqldump -u账号 -p 库名 > /root/backup_$(date +%Y%m%d).sql，导出后下载到本地
2. 环境检查
- 检查服务器剩余磁盘空间，执行以下命令查看：
```
df -h
```
预留空间需要大于目标软件安装包的1.5倍，一般预留2G以上即可满足绝大多数软件升级需求
- 暂停业务写入：如果是核心生产业务，暂时将网站域名解析到备用服务器，或者关闭站点，避免升级过程中数据写入导致损坏
二、方法一：面板内一键升级（推荐新手使用）
该方法全程可视化，无需敲命令，适合绝大多数场景，步骤如下：
- 登录宝塔面板后台，地址格式为
你的服务器IP:8888，输入账号密码完成登录
- 点击左侧导航栏软件商店，切换到已安装标签页，此处列出所有你在宝塔安装的软件
- 找到需要升级的目标软件，比如PHP 7.3升级到PHP 7.4、MySQL 5.7升级到8.0，点击软件右侧的升级按钮
- 在弹出的版本选择框中，选择你要升级的目标版本，重要提醒：跨大版本升级（如MySQL 5.7→8.0、PHP 5.6→7.4）必须先在测试环境验证兼容，不要直接在生产环境操作
- 点击确认升级，等待面板自动完成下载、编译、安装、配置迁移全流程，该过程根据服务器性能不同需要3-15分钟，不要关闭页面、不要重启服务器
- 升级完成后，面板会弹出升级成功提示，此时需要验证：点击软件右侧「设置」，确认版本号显示正确，点击重启软件，然后打开网站验证所有业务功能正常运行即可
三、方法二：命令行手动升级（适合升级失败/跨大版本升级）
如果面板内升级卡住、下载失败，可以用该方法操作，步骤如下：
1. 卸载旧版本程序
回到面板已安装软件列表，点击目标软件右侧「卸载」，弹出选项时，务必取消勾选「删除配置文件」「删除数据文件」，仅卸载程序本身，保留所有数据和配置，确认卸载等待完成。
2. 执行命令安装目标版本
连接服务器SSH，直接执行宝塔官方安装命令，命令格式统一，只需要替换版本号即可，示例如下：
- 安装指定版本PHP（示例为PHP 8.1，把81换成对应版本号即可，如74就是PHP 7.4）：
```
/www/server/panel/install/public.sh install php 81
```
- 安装指定版本MySQL（示例为MySQL 8.0，替换版本号即可，如57就是MySQL 5.7）：
```
/www/server/panel/install/public.sh install mysql 80
```
- 安装指定版本Nginx（示例为Nginx 1.24，直接替换版本号即可）：
```
/www/server/panel/install/public.sh install nginx 1.24
```
执行命令后等待安装完成，脚本会自动迁移旧版本的配置和数据，不需要手动修改配置。
3. 验证安装结果
安装完成后执行对应命令确认版本：
- PHP验证：
php -v
- MySQL验证：
mysql -V
- Nginx验证：
nginx -v
回到宝塔面板刷新已安装列表，确认版本信息显示正确，再验证网站业务正常即可。
四、升级失败/不兼容回滚方法
如果升级后出现业务不兼容、无法启动，按以下步骤快速回滚：
- 卸载当前升级的新版本，卸载时依旧不要勾选删除数据和配置
- 打开旧版本软件的设置页面，进入「备份」选项，选择升级前创建的备份，点击「恢复」
- 如果是手动命令安装旧版本，只需要把安装命令中的版本号替换为旧版本号，重新安装即可，安装完成后会自动恢复原有数据
- 恢复完成后重启软件，验证业务即可恢复正常
五、常见卡壳问题解决
1. 点击升级后没反应/一直卡住
一般是面板网络下载失败导致，等待5分钟刷新页面重试，如果还是失败直接改用命令行手动升级即可解决。
2. 升级完成后网站出现502/500错误
最常见的两个原因：一是PHP升级后缺失扩展，进入PHP设置→扩展安装，安装项目需要的ioncube、redis、sg11等扩展，重启PHP即可；二是服务没有正常启动，进入软件设置页点击启动即可。
3. MySQL升级后程序连接失败
MySQL 8.0默认加密规则和低版本不同，需要登录MySQL执行以下命令修改用户加密规则：
```
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码';
FLUSH PRIVILEGES;
```
修改完成后重启MySQL即可正常连接。
核心注意事项
1. 任何升级操作都必须先备份，不要抱有侥幸心理跳过备份步骤；
2. 跨大版本升级不要直接在生产环境操作，必须先在测试环境验证程序兼容后再操作；
3. 升级过程中不要重启服务器、不要中断安装流程，避免程序文件损坏导致无法启动。
