MySQL 9.7 的一次死锁修复,让合法的 CREATE TABLE 报 1118:从 9.7.0 到 9.7.4 的 DDL 校验反复
信源:dev.mysql.com 的 MySQL 9.7 Release Notes。
这是一条典型的「底层修复引出上层误拒」的链路:本来是为了消除一个 InnoDB B-tree 死锁,结果行大小估算变严,一批在旧 LTS 上合法存在的表定义被 DDL 校验挡了下来,直到 9.7.4 才把校验行为区分开。
| 版本 | 日期 | 变化 |
|---|---|---|
| 9.7.0 | 2026-04-21 | 更准确地计算最大索引记录尺寸,DDL 校验随之变严(Bug #39129182) |
| 9.7.2 | 2026-07-28 | 修复 SPATIAL KEY 场景下合法 DDL 被误拒(Bug #120504、#39433811) |
| 9.7.4 | 2026-10-20 | 大多数 DDL 恢复旧校验行为,仅防死锁处保留精确估算;INSTANT 仍严格(Bug #120323、#39249507) |
9.7.0:死锁是真的,修法也是真的
InnoDB 删除记录时有时需要合并 B-tree 页并更新父页。原来的实现会低估索引记录大小,于是可能以不安全的顺序去取 page latch,与并发的 B-tree 搜索撞成死锁。
9.7.0 改成更准确地计算最大记录大小,计算范围包括带索引前缀的字段和空间 GEOMETRY 索引。这样 InnoDB 会更早取到需要的 latch,死锁不再发生。
代价写在同一条 release note 里:一些超过文档中 InnoDB 限制的 CREATE TABLE / ALTER TABLE 现在会被正确拒绝。
9.7.2:误拒露头
9.7.0 上线后,合法语句开始被拒绝。涉及 InnoDB SPATIAL KEY 的 CREATE TABLE 或 INSERT 会返回 ER_TOO_BIG_ROWSIZE,报错原文是:
ER_TOO_BIG_ROWSIZE(1118) (42000): Row size too large (> 8126). Changing some columns to TEXT or BLOB may help. In current row format, BLOB prefix of 0 bytes is stored inline.
9.7.2 修掉了这个误拒(Bug #120504、Bug #39433811)。
判断自己撞上的是不是误判
三个条件同时成立,基本可以确定:
- 同一条建表语句在旧 LTS 上能通过,在 9.7.0 / 9.7.1 上失败;
- 表定义里存在带索引前缀的字段,或
SPATIAL KEY(GEOMETRY); - 报错就是 1118,且提示
Row size too large (> 8126)。
反过来说,如果你的表在旧 LTS 上同样被拒,那就不是这次回归的问题,按常规行大小优化处理。
临时绕过
在不能立刻升级的窗口期,可以选一条:
- 拆列:把宽表的列拆到关联表,缩短单行实际字节数。
- 改类型:按报错提示把部分列改成
TEXT/BLOB,行内只留指针。注意In current row format, BLOB prefix of 0 bytes is stored inline这句,改完要看实际行格式,别指望前缀能省出空间。 - 换算法:如果出问题的是 INSTANT DDL,显式指定
ALGORITHM=INPLACE,避开严格的 INSTANT 估算路径:
ALTER TABLE tbl_name
ADD COLUMN c VARCHAR(255) DEFAULT '',
ALGORITHM=INPLACE;
- 回退版本:退回改动前的版本,等 9.7.4 再动。
正规解法:升到 9.7.4
9.7.4 把这件事收口了:大多数 DDL 操作保留旧的校验行为,同时在需要防止 B-tree 死锁的地方保留精确估算。也就是说,校验强度不再一刀切。
有一个例外需要记住:ALTER TABLE ... ALGORITHM=INSTANT 继续使用更严格的计算,目的是安全处理大默认值(大 default value)。如果你大量依赖 INSTANT 加列带默认值,升级后仍可能在这条路径上遇到拒绝,此时改用 INPLACE 即可。
升级检查清单
- 把 CI 里所有
CREATE TABLE/ALTER TABLE语句收集起来,在 9.7.0 上完整跑一遍,记下被拒和产生 warning 的条目。 - 对每一条被拒的 DDL,回旧 LTS 验证一次,确认它原本合法。
- 含索引前缀或
SPATIAL KEY的表定义排在优先处理队列前面。 - 单独列出使用
ALGORITHM=INSTANT且带大默认值的变更,评估是否需要改 INPLACE。 - 升级到 9.7.4 后重跑同一批 DDL,确认误拒消失、warning 收敛。
9.7.4 里另外两条 InnoDB 修复
同版本还有两条与稳定性相关,值得一起看:
- InnoDB page reorganization 尺寸不匹配却没有记 redo,之后 insert + crash 可能导致恢复失败或页损坏。现在把这种不匹配当作致命错误处理(116574)。
IMPORT TABLESPACE失败后留下陈旧页,导致 eviction 时在btr0sea.cc:1082断言失败(39661792)。
两个 bug 的共同点是「状态不一致被静默放过,等到后面某一步才炸」。升级时把这两条和 DDL 校验一起纳入回归范围,比只盯 1118 更稳。