// MySQL 错误参考
MySQL 错误 1071:指定的键太长
索引宽度超过了 InnoDB 的限制(3072 字节,旧行格式为 767 字节),通常出现在很长的 utf8mb4 VARCHAR 上。
- 错误编号
1071- 名称
ER_TOO_LONG_KEY- SQLSTATE
42000- 类别
- 键和约束
它的意思
最大键长度按字节计算,而不是按字符。使用 utf8mb4 每个字符可以占用 4 个字节,因此 VARCHAR(255) 每列最多需要 1020 个字节。采用 DYNAMIC 或者 COMPRESSED 行格式的 InnoDB 允许每个索引 3072 个字节;较旧的 COMPACT 和 REDUNDANT 格式允许 767,这正是 VARCHAR(255) in utf8mb4 失败。
常见原因
- 唯一索引建在
utf8mb4VARCHAR,尤其是在 MySQL 5.6 或使用旧行格式时。 - 复合索引的各列加起来超过了上限。
如何修复它
-
使用
DYNAMIC行格式(自 MySQL 5.7 起为默认)。ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
对列的前缀建立索引,适用于非唯一索引。
CREATE INDEX idx_users_bio ON users (bio(191));
-
如果不需要长值,可以缩窄列宽,例如
VARCHAR(191)找到一封已建索引的邮件,在utf8mb4保持在 767 字节限制以内。
相关错误
更多键和约束错误
1062键存在重复条目1452外键约束失败:无法添加子行1451外键约束失败:无法删除父行1216无法添加或更新子行1217无法删除或更新父行1215无法添加外键约束3780外键列不兼容1822外键约束缺少索引
代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 MySQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。