案例 MySQL 9.7 的一次死锁修复,让合法的 CREATE TABLE 报 1118:从 9.7.0 到 9.7.4 的 DDL 校验反复

2026-11-17 21:07:28

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.02026-04-21更准确地计算最大索引记录尺寸,DDL 校验随之变严(Bug #39129182)
9.7.22026-07-28修复 SPATIAL KEY 场景下合法 DDL 被误拒(Bug #120504、#39433811)
9.7.42026-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 即可。

升级检查清单

  1. 把 CI 里所有 CREATE TABLE / ALTER TABLE 语句收集起来,在 9.7.0 上完整跑一遍,记下被拒和产生 warning 的条目。
  2. 对每一条被拒的 DDL,回旧 LTS 验证一次,确认它原本合法。
  3. 含索引前缀或 SPATIAL KEY 的表定义排在优先处理队列前面。
  4. 单独列出使用 ALGORITHM=INSTANT 且带大默认值的变更,评估是否需要改 INPLACE。
  5. 升级到 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 更稳。

复制全文 生成海报 MySQL DDL 升级 排查

推荐文章

程序员茄子在线接单