迁移至MySQL后Django出现Row size too large错误求助

核心结论 #

RichTextField确实可能是触发该错误的因素之一，但根本原因是MySQL的行大小限制机制，以及你将所有CharField改为TextField后带来的行总大小叠加问题。

具体分析 #

1. MySQL行大小限制规则
   InnoDB引擎下，表的行大小（不含BLOB/TEXT字段溢出到外部存储的内容）上限为65535字节。注意：

   • TEXT/BLOB字段本身的实际内容会溢出存储，但它们的长度标识头部（通常2-4字节）仍会占用行内空间。
   • 当你把所有CharField（对应MySQL的VARCHAR）改为TextField后，每个字段都额外占用了头部空间，多个这类字段叠加后，很容易让行内总大小触碰到65535的上限。

2. RichTextField的影响
   RichTextField本质是Django的TextField结合ckeditor的前端组件，在MySQL中依然映射为TEXT类型。如果你的表中存在多个RichTextField，再加上其他批量改成TextField的字段，所有字段的头部空间+非大字段的存储内容总和，就会触发行大小超限错误。

解决方案 #

• 还原不必要的TextField：只保留确实需要存储长文本的字段为TextField，短文本字段改回CharField（对应MySQL的VARCHAR），减少行内占用的头部空间。
• 拆分大字段到关联表：将RichTextField这类大字段移到单独的关联表中，主表仅存储关联ID，降低主表的行大小。
• 调整字符集：如果使用utf8mb4字符集（每个字符占4字节），会大幅增加字段的实际占用空间。对于不需要存储emoji等特殊字符的字段，可改为utf8字符集；或者缩短部分CharField的长度。
• 检查表结构总大小：计算所有字段的理论占用总和（注意字符集的字节数换算），确保行内总大小不超过65535字节。

内容的提问来源于stack exchange，提问作者Alireza javanpour