mysql_upgrade

MySQL/MariaDB 升级系统表

补充说明

mysql_upgrade 在大版本升级后检查并更新系统表、权限表和存储引擎元数据。注意：MySQL 8.0.16 起已移除该命令，改用服务端 --upgrade 选项；MariaDB 仍提供（新名称为 mariadb-upgrade）。

常用示例

# MariaDB
mysql_upgrade -u root -p
mariadb-upgrade -u root -p
mysql_upgrade -u root -p --force
mysql_upgrade -u root -p --upgrade-system-tables

# MySQL 8.0.16+
mysqld --upgrade=FORCE
mysqlcheck -u root -p --all-databases --check-upgrade

易错点与排错

• MySQL 8.0.16+ 没有 mysql_upgrade；照旧脚本会报命令不存在。
• 先做完整备份；升级系统表不可轻易回退。
• 需要 root 或等效权限；普通账号无法更新系统表。
• --force 会忽略部分错误继续执行，可能掩盖真正的不兼容。
• 大版本升级要在测试环境验证 SQL 兼容性、字符集和认证插件。
• MariaDB 的 mysql_upgrade 是兼容软链，脚本里建议用新名称。
• 升级后检查错误日志、插件、复制和备份任务。

相关命令

• mysqlcheck — 表和系统表检查
• mysqldump — 升级前备份
• mysql — 连接验证