MySQL 5.7 升级到 8.0 后 PARTITION BY RANGE 报错主因是 8.0 强制要求 innodb_file_per_table=ON 且仅支持 InnoDB 分区表;8.0.29+ 严格校验 LIST 分区 NULL 处理;ARCHIVE 分区表在 8.0 被彻底移除;8.0.33+ 限制 KEY 子分区列必须属于主分区键。

MySQL 5.7 升级到 8.0 后 PARTITION BY RANGE 报错:”ERROR 1064 (42000)“
这不是语法错误,而是 MySQL 8.0 默认禁用了 innodb_file_per_table=OFF 场景下的分区表创建(尤其当原表使用 MyISAM 或旧式共享表空间时)。8.0 要求所有分区表必须基于 InnoDB,且每个分区需独立物理文件 —— 这直接依赖 innodb_file_per_table=ON。
实操建议:
- 升级前检查:
SELECT @@innodb_file_per_table, @@default_storage_engine;
- 若为
0,需先在 5.7 环境执行SET GLOBAL innodb_file_per_table = ON;,再对每个分区表执行ALTER TABLE tbl_name ENGINE=InnoDB;触发文件拆分 - 禁止在 8.0 初始化实例后,用
mysqldump --compatible=mysql40导入含分区定义的 SQL —— 它会抹掉PARTITION子句但不报错,导致结构丢失
ALTER TABLE ... REORGANIZE PARTITION 在 8.0.29+ 中行为突变
MySQL 8.0.29 起,REORGANIZE PARTITION 对 LIST 分区的合法性校验更严格:不再允许合并包含 NULL 值的分区,也不接受新分区定义中遗漏原 VALUES IN 列表里的任意值。
常见错误信息:ERROR 1659 (HY000): Cannot move rows between partitions that have different definitions for handling NULL values
实操建议:
- 升级前运行
SELECT PARTITION_NAME, PARTITION_DESCRIPTION FROM INFORMATION_SCHEMA.PARTITIONS WHERE TABLE_NAME = 'your_table';检查是否有NULL显式出现在PARTITION_DESCRIPTION - 对含
NULL的LIST分区,改用ALTER TABLE ... EXCHANGE PARTITION+ 临时表方式重组,避免直接REORGANIZE - 8.0.29+ 的
REORGANIZE不再隐式复制数据,而是原子重写元数据 —— 若中途失败,分区状态不可逆,务必在低峰期操作并提前锁表
从 MySQL 5.6 迁移至 8.0 时 ARCHIVE 分区表直接失效
ARCHIVE 存储引擎自 MySQL 8.0 起被彻底移除,任何含 ENGINE=ARCHIVE 的分区定义在 8.0 实例启动时就会拒绝加载,错误日志显示:Unknown storage engine 'ARCHIVE',整个表无法访问。
这不是兼容性警告,是硬性阻断。
实操建议:
- 5.6/5.7 环境中,必须在迁移前将
ARCHIVE分区表转为InnoDB:ALTER TABLE archived_log_table ENGINE=InnoDB ROW_FORMAT=COMPRESSED KEY_BLOCK_SIZE=4;
- 不要试图用
mysqldump --skip-create-options绕过引擎声明 ——CREATE TABLE语句仍含ENGINE=ARCHIVE,导入 8.0 时照样失败 - 若原表仅用于归档且读写极少,可考虑迁出数据后改用 8.0 的
DATA DIRECTORY+ 只读表空间管理,而非保留分区逻辑
MySQL 8.0.33 后 subpartition 的 KEY 分区限制加剧
8.0.33 强制要求:子分区(SUBPARTITION)若使用 KEY 类型,其列必须全部来自主分区键(PARTITION BY 所用列),不能再引用额外列。此前版本虽不推荐但允许。
错误示例:
CREATE TABLE logs ( id BIGINT, ts DATETIME, region VARCHAR(10) ) PARTITION BY RANGE (YEAR(ts)) SUBPARTITION BY KEY (region) -- ❌ 8.0.33+ 拒绝:region 不在主分区键中
实操建议:
- 升级前扫描所有含
SUBPARTITION BY KEY的建表语句,确认子分区列是否严格属于主分区键字段集 - 如需按
region子分区,应改为PARTITION BY RANGE COLUMNS(ts, region),或用HASH子分区配合计算列 - 注意:8.0.33+ 的
KEY子分区不再支持ALGORITHM=INPLACE,变更必须重建全表
分区表迁移不是单纯 dump & restore,引擎限制、语法容忍度、元数据校验强度都在逐版本收紧。最容易被忽略的是那些“曾经能跑”的隐式行为 —— 比如 5.7 允许的 NULL 分区合并、ARCHIVE 表跨版本加载、子分区列自由引用,到了 8.0 某个补丁版就变成硬性报错。动手前务必查清目标小版本的具体变更日志,别只看大版本号。










