升级前必须验证的5个关键权限:①mysql库全表SELECT/UPDATE权限;②root用户SYSTEM_USER权限;③旧用户认证插件显式声明;④WITH GRANT OPTION用户记录完整性;⑤复制环境REPLICATION SLAVE ADMIN和BACKUP_ADMIN权限。

升级前必须验证的 5 个关键权限
MySQL 升级失败,80% 出现在 mysql 系统库权限缺失或不一致上。新版本(尤其是 8.0+)对 mysql.user、mysql.global_grants、mysql.role_edges 等表结构和访问控制逻辑更严格。
-
SELECT和UPDATE权限必须覆盖整个mysql库,不能只给个别表(如只授权mysql.user会卡在mysql_upgrade检查阶段) - 确保 root 用户拥有
SYSTEM_USER权限(MySQL 8.0.12+ 强制要求),否则mysqld --upgrade会报错Access denied; you need (at least one of) the SYSTEM_USER privilege(s) - 检查是否存在用
mysql_native_password插件认证但未显式指定plugin字段的旧用户——升级后默认插件变为caching_sha2_password,这类用户会无法登录 - 若使用了
CREATE USER或GRANT中的WITH GRANT OPTION,需确认被授权用户是否仍在mysql.tables_priv或mysql.procs_priv中有对应记录,否则升级后权限丢失 - 复制环境要额外验证
REPLICATION SLAVE ADMIN和BACKUP_ADMIN权限(MySQL 8.0.22+ 新增),缺失会导致START SLAVE失败
my.cnf 配置项兼容性陷阱
MySQL 8.0 移除了大量旧参数,且部分参数行为变更。直接复用 5.7 的 my.cnf 很可能让服务启动失败或产生静默异常。
- 必须删除已废弃参数:
query_cache_type、query_cache_size、expire_logs_days(改用binlog_expire_logs_seconds)、innodb_locks_unsafe_for_binlog -
default_authentication_plugin默认值从mysql_native_password变为caching_sha2_password,若客户端不支持,需显式设回原值,或提前批量修改用户认证方式 -
sql_mode默认值新增STRICT_TRANS_TABLES和NO_ENGINE_SUBSTITUTION,老应用若依赖宽松模式(如允许插入超长字符串截断),需评估并调整 -
lower_case_table_names在 macOS / Windows 上仍可设为1,但在 Linux 上若数据目录已有大写表名,强行设为1会导致启动报错Table 'xxx' doesn't exist
mysql_upgrade 不再是必需步骤,但仍有隐藏作用
MySQL 8.0.16+ 默认启用 --upgrade=auto,启动时自动执行系统表升级;但手动运行 mysql_upgrade 仍有必要,尤其在跨大版本(如 5.7 → 8.0)迁移时。
- 它会重建
mysql.help_topic、修复mysql.proc到mysql.routines的映射、更新performance_schema表结构 - 必须用升级后的
mysql客户端连接,且账户需有CREATE、INSERT、UPDATE、DELETE、DROP权限——用旧客户端或权限不足会提示Unknown system variable 'show_compatibility_56' - 若遇到
Failed to open file 'mysql/proc.MYD',说明还在用 MyISAM 系统表(5.7 以前),需先停服,用mysqld --skip-grant-tables启动,再执行ALTER TABLE mysql.proc ENGINE = InnoDB;等修复
配置文件迁移的最小安全操作清单
不要整份拷贝 my.cnf。应逐项判断,优先保留业务强依赖项,剔除冗余和过时配置。
[mysqld] # 必须保留(按实际路径调整) datadir = /var/lib/mysql socket = /var/run/mysqld/mysqld.sock pid-file = /var/run/mysqld/mysqld.pid必须显式声明(8.0 默认值可能破坏兼容性)
default_authentication_plugin = mysql_native_password sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
推荐保留(性能与安全基础)
innodb_buffer_pool_size = 2G max_connections = 200 log_error = /var/log/mysql/error.log
删除或注释掉(已失效或由新机制接管)
query_cache_type = 0
expire_logs_days = 7
innodb_file_per_table = 1 # 8.0 默认 ON
升级后第一件事:用 mysql --version 和 SELECT VERSION(), @@sql_mode; 双重确认版本与运行时配置生效状态。很多问题不是升级失败,而是配置没加载或被覆盖(比如 /etc/my.cnf 被 /etc/mysql/my.cnf 优先加载)。










