必须先运行util.checkForServerUpgrade()扫描兼容性,否则直接替换二进制将导致启动失败或数据不可用;需使用与目标MySQL 8.0版本匹配的MySQL Shell(如升至8.0.42则用8.0.42版shell),通过socket连接5.7实例并指定configPath参数执行检查,报告overallStatus非OK时禁止继续升级。

util.checkForServerUpgrade()必须先跑,否则直接替换二进制大概率启动失败或数据不可用。
必须用匹配版本的 MySQL Shell 连接 5.7 实例做兼容性扫描
不是装个 mysql-shell 就能用,必须下载目标 MySQL 8.0 版本对应的 mysqlsh(比如升到 8.0.42,就得用 8.0.42 的 shell),否则检查结果不可信。连接方式要稳定,优先走 socket:
./mysqlsh -uroot -p -S /tmp/mysql.sock -e "util.checkForServerUpgrade({'configPath': '/etc/my.cnf'})"- 加
configPath参数才能检查配置项,否则只扫数据库对象 - 输出重定向到文件:
> upgrade-check.log 2>&1,方便后续 grep ERROR - 报告里
overallStatus不是 OK,就别往下走
ERROR 级条目必须逐条修复,不能跳过
常见 ERROR 类型和对应动作:
-
Usage of utf8mb3 charset:改表/列字符集为utf8mb4,否则 emoji 存不进去 -
Column name 'rank' is a reserved keyword:重命名字段或表,rank、json、role等都是 8.0 关键字 -
NO_AUTO_CREATE_USER is present in sql_mode:从my.cnf的sql_mode里删掉这一项 -
MyISAM engine used:查出所有 MyISAM 表:SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE ENGINE = 'MyISAM',然后ALTER TABLE ... ENGINE=InnoDB - 系统库下有自定义表撞名(如
mysql.roles):必须重命名或删掉,8.0 的mysql库结构完全不兼容
my.cnf 配置必须手动清理和补全三处关键项
MySQL 8.0 启动时会校验参数,很多 5.7 兼容但 8.0 已废弃的配置会导致秒退或卡在 Starting MySQL:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 删掉已废弃项:
query_cache_type、explicit_defaults_for_timestamp、innodb_file_format - 显式设置认证插件:
default_authentication_plugin=mysql_native_password(否则老 JDBC/PyMySQL 连不上) - 字符集必须明确指定:
character_set_server=utf8mb4和collation_server=utf8mb4_0900_ai_ci;别留latin1,混合字符集易引发索引失效 -
sql_mode中若含NO_AUTO_CREATE_USER,启动直接报错退出,不是警告
导出导入时严禁包含系统库,且必须显式指定字符集
绝不能用 mysqldump --all-databases,mysql 库在 5.7 和 8.0 完全不兼容(字段名、权限模型、引擎强制要求都变了):
- 只导业务库:
mysqldump --default-character-set=utf8mb4 -u root -p --databases myapp_db other_db - 加
--single-transaction --routines --triggers --events,避免锁表和漏定时事件 - 如果误导了
mysql库,必须手动删掉所有CREATE DATABASE mysql、USE mysql和INSERT INTO mysql.行 - 导入前确认新实例已启动且
mysql系统库是干净的——它由mysqld自动初始化,不能覆盖
实际操作中最容易被忽略的是 SELinux 上下文和 datadir 权限。CentOS/RHEL 下替换二进制后,/usr/local/mysql 目录的上下文常被破坏,得补一句:chcon -R --reference=/var/lib/mysql /usr/local/mysql;/var/lib/mysql 属主也必须是 mysql:mysql,哪怕你用 rpm 安装也得再 check 一遍。










