编程 CREATE TABLE 突然报 Row size too large:MySQL 8.4.11 只回退了大部分 DDL 的行大小校验

2026-11-22 21:01:13

CREATE TABLE 突然报 Row size too large:MySQL 8.4.11 只回退了大部分 DDL 的行大小校验

来源:

MySQL 9.7.4 与 MySQL 8.4.11(均为 2026-10-20 发布)的 InnoDB Notes 里有一条容易被当成普通 bug fix 略过的说明:之前一次死锁修复把行大小估算改准了,副作用是 CREATE TABLE / ALTER TABLE 的校验变严;从这个版本起,大部分 DDL 恢复旧校验行为,但 ALGORITHM=INSTANT 仍然走严格计算。

发布说明原文

InnoDB: A previous InnoDB deadlock fix made row-size estimates more accurate for B-tree operations, but also made CREATE TABLE and ALTER TABLE validation stricter. As a result, some table definitions accepted by earlier MySQL LTS releases were unexpectedly rejected or produced warnings, disrupting existing applications. As of this release, the legacy validation behavior is preserved for most DDL operations while retaining the accurate estimate where it is needed to prevent B-tree deadlocks. ALTER TABLE ... ALGORITHM=INSTANT continues to use the stricter calculation to safely handle large default values. (Bug #120323, Bug #39249507) References: Bug #39129182

拆开看是三层意思:

  1. 旧行为回来了:大多数 DDL 的校验按老版本宽松口径走。
  2. 严格计算没有全丢:在防止 B-tree 死锁需要的地方仍然保留准确估算。
  3. 例外是 ALTER TABLE ... ALGORITHM=INSTANT,它继续用严格计算,理由是“安全处理大的默认值”。

三个 Bug 号的关系

这里容易看混,需要分开:

  • Bug #39129182:原始的死锁修复。它让 InnoDB 在 B-tree 操作中对行大小的估算更准确,是整条链的起点。
  • Bug #120323:由这次改动引出的公开回归报告。原来在更早 8.4 版本能建的表,升级后 CREATE TABLE / ALTER TABLE 被拒绝或产生 warning,报错是 Row size too large。受影响者包括一家有大量客户安装的软件厂商。
  • Bug #39249507:8.4.11 发布说明中记录“如何处置”的条目,即恢复大多数 DDL 的旧校验、保留必要处的严格估算,并引用 Bug #39129182。

也就是说,Bug #39129182 是原因,Bug #120323 是症状,Bug #39249507 是修复方案。发布说明把三者串在一起,读的时候不要当成同一件事的三个编号。

为什么两个 LTS 系列的修复不一样

Oracle 那篇博客讲的就是这个问题:MySQL 8.4 和 9.7 都是 LTS,但同一条修复不一定会同时出现在两个系列里。代码基线不同,行为可能不同;更重要的是,改动会影响依赖既有行为的应用。

这次的案例很典型。修复本身是对的——更准的行大小估算避免了潜在死锁;但“更准”意味着原来能过的定义现在过不了,对已经在 LTS 上跑着的应用就是破坏性变更。处置方式不是简单回滚,而是在 8.4.11 中保留防死锁所需的计算,同时对大多数 DDL 恢复旧校验。

博客里还提到一个流程细节:另一个受影响客户需要在其平台上带此修复的定制构建,客户验证之后,兼容性改动才被纳入标准 8.4.11 发布。最终结论是取舍——在保留死锁保护和避免打断已在 LTS 上运行的既有应用之间选。Oracle 季度 CPU 是维护发布的主要节奏,Critical Security Patch Update 是季度之间针对关键安全/稳定性问题的补充通道,这类兼容性修正通常就落在这两个窗口里。

INSTANT 为什么不能一起回退

发布说明给的理由只有一句:ALGORITHM=INSTANT 继续使用更严格的计算,以安全处理大的默认值。

INSTANT 的变更主要在元数据层完成,不重建表,但新增列、改默认值这些操作需要在读取旧行时把缺失部分物化出来。行内空间估算如果按旧的宽松口径算,遇到大默认值就可能在 B-tree 路径上重新触发当初那个死锁修复要解决的问题。换句话说,这条路径正是严格估算存在的意义所在,回退等于把原来的 bug 放回来。

具体实现在发布说明里没有展开,能确定的只有行为边界:ALTER TABLE ... ALGORITHM=INSTANT 仍然严格,其它 DDL 回到宽松。

自查:先看列字节数,再看页大小

第一步是找出“看起来没问题、按严格口径算却超限”的表。information_schema.COLUMNS 里的 CHARACTER_OCTET_LENGTH 直接给出该列的最大字节数,utf8mb4 下每字符按 4 字节算:

SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME,
       DATA_TYPE, CHARACTER_MAXIMUM_LENGTH, CHARACTER_OCTET_LENGTH,
       CHARACTER_SET_NAME
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA NOT IN ('mysql','sys','information_schema','performance_schema')
  AND DATA_TYPE IN ('varchar','char','varbinary','binary','text','blob')
ORDER BY CHARACTER_OCTET_LENGTH DESC;

把同一张表的变长列按 CHARACTER_OCTET_LENGTH 加总,再和行最大长度上限比对。上限与 innodb_page_size 绑定,页越大上限越高,具体阈值以对应版本的 InnoDB Limits 文档为准:

SHOW VARIABLES LIKE 'innodb_page_size';

注意 DYNAMIC 行格式下,超长的变长列会溢出到 off-page,行内只留指针,所以真正计入行大小的是行内那部分。估算时不要把整列长度都算进去,但也不要漏掉指针和大默认值。

第三步是实测 INSTANT 路径。对目标表执行一条带默认值的新增列语句,观察是否直接报 Row size too large:

ALTER TABLE t
  ADD COLUMN c VARCHAR(255) DEFAULT '...' ,
  ALGORITHM=INSTANT;

失败表现是语句直接报错退出,不会留下部分变更;同一份定义在 CREATE TABLE 或非 INSTANT 的 ALTER 上可能已经通过。这种“同一张表,换个算法结果不同”的差异,就是本次改动最直接的体感。

升级前后怎么处理

升级前:

  • 把目标实例的 SHOW CREATE TABLE 全量导出,在 8.4.11 / 9.7.4 的测试实例上跑一遍。重点抓宽表:列数多、VARCHAR 多、字符集是 utf8mb4 的表。
  • 核对待升级实例与目标实例的 innodb_page_size。页大小不同,行上限不同,估算结果不能直接搬。
  • 把上面那条 information_schema.COLUMNS 查询的结果按表聚合,标出接近上限的表,优先人工复核。
  • 迁移脚本里带 ALGORITHM=INSTANT 的 DDL 单独列出来,这些是升级后最可能失败的语句。

升级后:

  • 如果 CREATE TABLE 仍报 Row size too large,先确认它是不是真的超过了物理上限,而不是把新回归又当成旧问题。
  • 如果失败的是 ALTER TABLE ... ALGORITHM=INSTANT,改用 INPLACE 或 COPY 通常能回到宽松校验路径,代价是锁表和重建。是否可用取决于表大小和业务窗口,先在测试库验证。
  • 结构上能改的,优先改结构:把大 VARCHAR 拆到子表,或改成 TEXT / BLOB,让行内只保留指针。这比调页大小现实得多。
  • 确认是兼容性问题而非真实超限的,按 Bug #120323 的线索向 Oracle 反馈,附上 SHOW CREATE TABLE、innodb_page_size 和完整报错。

同期其他修复

9.7.4 还修了 deferred FULLTEXT 分词时 MeCab 解析失败的问题:基础行已提交,但 token postings 不完整,表现为搜索漏行。现在会给客户端 warning,错误日志形如:

[ERROR] [MY-011123] [Server] Mecab: parse() failed: too long sentence..

(Bug #39838534)

8.4.13 另有两项:optimizer_switch 设置 index_merge_union=off 时,disjunctive 条件的 index-merge 计划可能漏掉一个 disjunct,返回不完整结果(Bug #114885、Bug #36584358);ALTER TABLE ... EXCHANGE PARTITION 现在双向检查 CHECK 约束(Bug #120206)。

需要说明的是,9.7.4 的 InnoDB 说明中这一条与 8.4.13 相同,8.4.13 与 9.7.4 同为 2026-10-20 发布;而 8.4 LTS 上首次纳入该兼容性处理的是 8.4.11。两个版本号在发布说明和博客里分别出现,读的时候按各自对应的系列理解即可。

复制全文 生成海报 MySQL InnoDB 数据库运维

推荐文章

程序员茄子在线接单