MySQL 5.6 升级至 8.0:避开那些“坑”,让迁移更丝滑

说起从 MySQL 5.6 迁移到 8.0,很多人的第一反应是检查存储引擎兼容性。确实,InnoDB 引擎本身是向后兼容的,但这恰恰容易让人掉以轻心。迁移失败,很多时候问题并不出在引擎本身,而是藏在表结构、SQL 语义甚至是系统表名的冲突里——尤其是那些依赖于旧版 mysql 或 information_schema 系统表行为的业务逻辑,往往是升级路上的“暗礁”。
检查分区表是否全为 InnoDB 引擎
这是一个硬性规定:MySQL 8.0 彻底不再支持 MyISAM 分区表,只允许 InnoDB 引擎的分区表存在。如果你的库里有非 InnoDB 的分区表,无论是用 mysqldump 导出还是使用在线升级工具,都会直接报错中断,没有商量余地。
- 首先,用这条命令把“问题表”揪出来:
SELECT table_schema, table_name, engine, create_options FROM information_schema.tables WHERE create_options LIKE '%partitioned%' AND engine != 'InnoDB'; - 对于查到的 MyISAM 分区表,必须在升级前将其转换为 InnoDB 引擎:
ALTER TABLE db.tbl ENGINE=InnoDB;。需要提醒的是,这个操作在 5.6 上可能会锁表,务必评估好业务影响和时间窗口。 - 转换完成后,最好再检查一次
create_options字段,确认其仍然包含partitioned标识,避免误判。
排查 INNODB_ 开头的自定义表名冲突
MySQL 8.0 在 information_schema 和 performance_schema 中新增了大量以 INNODB_ 开头的系统视图(例如 INNODB_TRX、INNODB_METRICS)。如果你的数据库中恰好有同名的用户自定义表,升级后就会导致查询失败或元数据混乱,可谓“鸠占鹊巢”。
- 运行以下查询进行排查:
SELECT table_schema, table_name FROM information_schema.tables WHERE table_name REGEXP '^INNODB_' AND table_schema NOT IN ('information_schema','performance_schema','mysql'); - 一旦发现,这类用户表必须重命名。例如:
RENAME TABLE mydb.INNODB_LOGS TO mydb.my_innodb_logs; - 这里有个细节需要注意:在 Linux 系统上,表名是区分大小写的。
innodb_logs和INNODB_LOGS会被视为不同的对象。但是,8.0 的系统视图名称是全大写的,仍然可能引发解析歧义,所以最稳妥的办法还是彻底避开这个前缀。
验证 sql_mode 中是否含废弃参数
MySQL 8.0 移除了多个旧版的 sql_mode 值,比如 NO_AUTO_CREATE_USER、ERROR_FOR_DIVISION_BY_ZERO 等。像 STRICT_TRANS_TABLES 虽然保留了,但其行为也发生了变化。如果 5.6 实例的配置中显式设置了这些废弃值,升级后可能导致服务启动失败,或者模式被静默重置,从而影响业务SQL的执行结果。
- 先查看当前的全局设置:
SELECT @@global.sql_mode; - 重点检查和剔除:
NO_AUTO_CREATE_USER(此参数已彻底移除)、PIPES_AS_CONCAT(虽未移除但默认关闭,建议显式移除以防后续兼容性问题)。 - 一个推荐的、安全的
sql_mode最小集合是:STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION,REAL_AS_FLOAT(确保不包含任何废弃项)。 - 修改方式上,务必在配置文件
my.cnf的[mysqld]段落中进行设置,而不是仅仅在运行时使用SET命令,以免服务器重启后配置失效。
确认外键名与 ENUM/SET 元素长度限制
MySQL 8.0 收紧了某些元数据的长度限制。外键约束名的长度上限从原先较为宽松的状态收紧到了 64 个字符。同时,ENUM 或 SET 列中单个元素的最大长度,也从 255 字符(或 1020 字节)变为硬性限制。超出这些限制,会直接触发 ER_TOO_LONG_IDENT 或 ER_TOO_BIG_ENUM 错误。
- 检查超长的外键名:
SELECT CONSTRAINT_NAME, TABLE_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE CONSTRAINT_SCHEMA = 'your_db' AND LENGTH(CONSTRAINT_NAME) > 64; - 检查超长的 ENUM/SET 元素:
SELECT TABLE_NAME, COLUMN_NAME, COLUMN_TYPE FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND (COLUMN_TYPE LIKE 'enum(%' OR COLUMN_TYPE LIKE 'set(%') AND (CHAR_LENGTH(COLUMN_TYPE) > 1020 OR LENGTH(COLUMN_TYPE) > 1020); - 修复建议:对于超长的外键名,可以考虑缩写(例如去掉冗余的业务前缀)。对于 ENUM/SET 元素,则用更短的标识符替代(比如将
'active'改为'A')。这些操作最好在迁移前完成,避免升级后执行ALTER TABLE时卡住。
除了上述几个主要检查点,还有一些细节同样不容忽视。例如,在 GROUP BY 子句里使用 ASC/DESC 排序的写法——MySQL 5.6 允许,但 8.0 会直接报 ER_PARSE_ERROR 语法错误。再比如字符集,虽然 utf8mb3 在 8.0 中仍能运行,但所有新建对象的默认字符集都变成了 utf8mb4,混合使用可能导致隐式转换,进而引发索引失效等问题。这些“坑”往往不会在预检报告里高亮显示,却极有可能在升级上线后立刻暴露出来,值得投入精力仔细排查。
