宝塔 MySQL 5.7 升级 8.4:7 分钟停机实录

AI 摘要997笔记AI

MySQL 5.7 已停止维护,漏洞无补丁。文章记录在宝塔环境用官方预编译包升级至 8.4 LTS:先做逻辑、物理、配置三重备份,再用独立数据目录预演,最后停机切换,实际仅 7 分钟。该方案避开宝塔切换的源码编译和动数据目录风险,并总结七个坑与回滚方法。

此内容由AI根据文章内容自动生成。

服务器上的 MySQL 还是 5.7.44,一直没动过——能跑就不折腾,这是很多人的真实状态。但 5.7 在 2023 年 10 月就已经停止维护了,新爆出的漏洞不会再有补丁。这次花了二十分钟把它升到 8.4 LTS,实际停机 7 分钟。

这篇是完整实录:为什么不能直接用宝塔的「切换版本」、预编译包怎么部署、切换那几分钟具体做了什么、以及七个不查文档绝对踩不到的错误。

这篇适合谁

用宝塔面板、数据库在 5.7 或 8.0、想升到 8.4 LTS 的人。整套流程对服务器配置要求不高,2 核 4G 就够。文中所有命令都可以直接复制,改一下路径和密码即可。

一、为什么必须升

MySQL 的生命周期是这样的:

版本 支持状态 说明
MySQL 5.7 2023 年 10 月已 EOL 不再有安全补丁
MySQL 8.0 2026 年 4 月 EOL 过渡版本,不适合长期
MySQL 8.4 LTS 支持到 2032 年 当前推荐
MySQL 9.x 创新版 半年一换,不适合生产

5.7 停止维护快三年了。虽然数据库只监听本地、外网连不上,但一旦博客插件有 SQL 注入,5.7 上的提权路径是现成的——因为没有补丁可打。

二、为什么不用宝塔自带的切换

宝塔的「软件商店 → 数据库 → 切换版本」看着最省事,但有两个问题。

第一,它是源码编译。脚本里是 make -j${cpuCore},在 2 核的机器上编译 MySQL 8.4 要 40 到 90 分钟,而且编译峰值内存能到 2-3GB。我那台机器总共 3.7GB 内存、可用只有 1.5GB,大概率 OOM。

第二,它的安装脚本会动你的数据目录。翻脚本能看到这段:

[ -d "/www/backup/oldData" ] && rm -rf /www/backup/oldData
mv -f $Data_Path  /www/backup/oldData

直接把你现有的数据目录挪走再重新初始化。中途失败的话,恢复要手工搬家。

所以我改用官方预编译包 + 独立数据目录预演:不动生产数据,先在旁边跑一个完整实例验证,确认没问题再切。整个过程停机只有切换那几分钟。

三、第一步:三重备份

升级前的三重备份与回滚路径
逻辑备份、物理备份、配置备份各一份,任何一步出问题都能退回去

三种备份各有用途,缺一不可:

BK=/www/backup/mysql_pre_upgrade_$(date +%Y%m%d-%H%M)
mkdir -p $BK

# 1. 逻辑备份(可读、可选择性恢复)
mysqldump -uroot -p"$PW" --all-databases --single-transaction \
  --routines --triggers --events \
  --default-character-set=utf8mb4 > $BK/all_databases.sql

# 2. 物理备份(整目录打包,回滚用)
tar czf $BK/datadir.tar.gz -C /www/server data

# 3. 配置与启动脚本
cp -p /etc/my.cnf $BK/my.cnf.bak
cp -p /etc/init.d/mysqld $BK/mysqld.init.bak

# 验证 SQL 完整性(结尾必须有这行)
tail -1 $BK/all_databases.sql | grep "Dump completed"

那个「Dump completed」的检查别省。备份中断的话文件照样存在,只是内容不全,等到恢复时才发现就晚了。

四、预演:独立数据目录跑起来

数据库迁移的五个步骤:下载、预演、导入、切换、验证
先在一套独立环境里把所有问题暴露完,再动生产

下载官方预编译包(Debian 13 的 glibc 版本足够新,用 glibc2.28 的包就行):

cd /root
curl -sL -o mysql84.tar.xz \
  "https://cdn.mysql.com/Downloads/MySQL-8.4/mysql-8.4.7-linux-glibc2.28-x86_64.tar.xz"
tar -xJf mysql84.tar.xz -C /www/server
mv /www/server/mysql-8.4.7-linux-glibc2.28-x86_64 /www/server/mysql84
/www/server/mysql84/bin/mysqld --version

关键一步:写一个独立配置文件,别让它读 /etc/my.cnf。原因下一节说。

cat > /etc/my84test.cnf <<'EOF'
[mysqld]
user = mysql
basedir = /www/server/mysql84
datadir = /www/server/mysql84data
port = 3307
socket = /tmp/mysql84.sock
pid-file = /tmp/mysql84.pid
log-error = /tmp/mysql84.err
bind-address = 127.0.0.1
mysql-native-password = ON
open-files-limit = 65535
innodb_buffer_pool_size = 256M
innodb_redo_log_capacity = 64M
skip-name-resolve
EOF

ulimit -n 65535
/www/server/mysql84/bin/mysqld --defaults-file=/etc/my84test.cnf --initialize-insecure

然后启动、导入、验证。这一步完全不影响生产(端口 3307,独立数据目录):

nohup /www/server/mysql84/bin/mysqld \
  --defaults-file=/etc/my84test.cnf >/dev/null 2>&1 &

# 只导业务库(原因见坑 3)
mysqldump -uroot -p"$PW" --single-transaction --routines --triggers \
  --databases db1 db2 db3 > /tmp/app_only.sql
sed -i 's/NO_AUTO_CREATE_USER,//g' /tmp/app_only.sql

/www/server/mysql84/bin/mysql --socket=/tmp/mysql84.sock -uroot < /tmp/app_only.sql

导完对比两边的表数量,一致才算过。我这边六个库分别是 23 / 20 / 12 / 15 / 20 / 12 张表,升完一个不差。

五、切换:7 分钟停机

升级过程的时间线,中间一小段为停机窗口
真正的停机只有切换那几分钟,预演阶段完全不影响线上

预演通过后,切换到生产。核心就是「换目录 + 换配置 + 启动」:

# 1. 停旧库
/etc/init.d/mysqld stop

# 2. 目录改名(旧的不删,留着回滚)
mv /www/server/data        /www/server/data_57_bak
mv /www/server/mysql84data /www/server/data
mv /www/server/mysql       /www/server/mysql_57_bak
mv /www/server/mysql84     /www/server/mysql
chown -R mysql:mysql /www/server/data
echo "8.4" > /www/server/mysql/version.pl   # 宝塔靠这个识别版本

# 3. 新配置
cp -p /etc/my.cnf /etc/my.cnf.57bak
cat > /etc/my.cnf <<'EOF'
[client]
port = 3306
socket = /tmp/mysql.sock
default-character-set = utf8mb4

[mysqld]
port = 3306
socket = /tmp/mysql.sock
datadir = /www/server/data
basedir = /www/server/mysql
bind-address = 127.0.0.1
user = mysql
open-files-limit = 65535
mysql-native-password = ON
character-set-server = utf8mb4
collation-server = utf8mb4_general_ci
# 这行是重点:不能带 ONLY_FULL_GROUP_BY
sql_mode = STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION
innodb_buffer_pool_size = 384M
innodb_redo_log_capacity = 128M
mysqlx = OFF
skip-name-resolve
EOF

# 4. 启动并验证
/etc/init.d/mysqld start
mysql -uroot -p"$PW" -e "select version();"

停机窗口就是第 1 步到第 4 步之间,实测 7 分钟。其中还包括一次启动失败(参数写错,见坑 4),修完重启才起来。

六、七个坑

坑 1:新实例会去读 5.7 的数据目录。因为 /etc/my.cnf 里有这两行:

innodb_data_home_dir = /www/server/data
innodb_log_group_home_dir = /www/server/data

新实例初始化时被它们拽着去打开 5.7 的 ibdata1,报错「ibdata1 不存在但另一个 ibdata1 存在」。解决办法就是预演阶段用 --defaults-file 指定独立配置,完全绕开 /etc/my.cnf。

坑 2:dump 里的 NO_AUTO_CREATE_USER 8.x 不认。5.7 的 mysqldump 会写进 sql_mode,导入 8.4 直接报错。导之前先过滤:

sed -i 's/NO_AUTO_CREATE_USER,//g' dump.sql

坑 3:mysql 系统库不能导。报 ERROR 3554 Access to system table 'mysql.innodb_index_stats' is rejected。更麻烦的是——只要你尝试过一次,它会往新实例写入 5.7 的 MyISAM 系统表,把这个实例搞脏,之后再执行 GRANT 会报 db.MYD not found,只能重新初始化。所以只导业务库,账号单独迁。

坑 4:default_authentication_plugin 在 8.4 被移除了。写进 my.cnf 会直接启动失败,报 unknown variable。改用 mysql-native-password = ON。

坑 5:文件句柄上限 1024 太小。InnoDB 打不开 redo 文件,报 Unable to open './#innodb_redo/#ib_redo15',而且会每秒重试一次刷屏。要在 my.cnf 里设 open-files-limit = 65535,初始化前还要 ulimit -n 65535。

坑 6:账号密码能直接搬,授权会漏。密码哈希跨版本兼容,可以这样复制:

SELECT CONCAT('CREATE USER ''',user,'''@''',host,''' IDENTIFIED WITH mysql_native_password AS ''',authentication_string,''';')
FROM mysql.user WHERE authentication_string<>'';

但授权不能只看 mysql.db 表——有些库的授权不在那里面。我导完之后有两个站直接 500,就是因为少了 GRANT ALL ON db.* TO 'user'@'localhost'。注意是 @localhost,站点走 socket 连接,只给 @127.0.0.1 不够。

坑 7:8.4 默认开 X Protocol,监听 33060 且对全网开放。升级完 ss -lntp 会多出一个 *:33060。如果不需要 MySQL Shell 的 X 协议,在 my.cnf 加 mysqlx = OFF。

七、验证与回滚

验证要分三层:账号能连、数据对得上、应用能跑。

# 1. 版本与 sql_mode
mysql -uroot -p"$PW" -e "select version(); select @@sql_mode;"

# 2. 每个库的表数量
mysql -uroot -p"$PW" -N -e "
  select table_schema, count(*) from information_schema.tables
  where table_schema not in ('mysql','information_schema','performance_schema','sys')
  group by table_schema;"

# 3. 用站点真实密码连一次(最容易漏)
mysql -u站点用户 -p站点密码 -e "select count(*) from 站点库.wp_posts;"

# 4. 访问站点首页,确认不是 500
curl -sk -H "Host: www.example.com" https://127.0.0.1/ -o /dev/null -w "%{http_code}\n"

第 3 步特别重要。我一开始只验证了 root,站点全 500 才发现是账号授权没补。用 wp-config.php 里的真实用户名密码测一次,一秒钟的事。

回滚很简单,旧的目录和配置都留着:

/etc/init.d/mysqld stop
mv /www/server/mysql /www/server/mysql_84_fail
mv /www/server/mysql_57_bak /www/server/mysql
mv /www/server/data /www/server/data_84_fail
mv /www/server/data_57_bak /www/server/data
cp -p /etc/my.cnf.57bak /etc/my.cnf
/etc/init.d/mysqld start

八、升级之后

现在跑的是 MySQL 8.4.7,六个库数据完整,四个站点全部 200,宝塔面板的数据库页面也正常(它靠 /www/server/mysql/version.pl 识别版本)。

有两点要记住:

一、每次 apt 升级系统包之后,如果动了 MySQL 相关依赖,重启前先 mysqld --version 确认还是 8.4。用 mv 换目录的方式,系统包管理器不知道你的 MySQL 在哪,一般不会碰,但确认一下不亏。

二、mysql_native_password 插件在 9.0 会被彻底移除。8.4 能用到 2032 年,不着急;但真要升 9.x 时,账号得切到 caching_sha2_password,届时 PHP 和面板的驱动都要重新验证一遍。

最后一句:升级数据库这事,预演比勇气重要。先在旁边跑一套完整的,把所有报错都撞一遍,真正切换的时候只需要换目录和重启。我这次预演阶段踩了六个坑,切换阶段只踩了一个。

上一篇 PHP严重漏洞-PHP 8.3 升级 8.5:imagick 编译失败与四个坑
下一篇 网站优化首屏从 400ms 压到 20ms:EdgeOne 缓存与图片压缩实战