// MySQL 错误参考

MySQL 错误 1071:指定的键太长

索引宽度超过了 InnoDB 的限制(3072 字节,旧行格式为 767 字节),通常出现在很长的 utf8mb4 VARCHAR 上。

错误编号
1071
名称
ER_TOO_LONG_KEY
SQLSTATE
42000
类别
键和约束
错误信息
Specified key was too long; max key length is %d bytes

它的意思

最大键长度按字节计算,而不是按字符。使用 utf8mb4 每个字符可以占用 4 个字节,因此 VARCHAR(255) 每列最多需要 1020 个字节。采用 DYNAMIC 或者 COMPRESSED 行格式的 InnoDB 允许每个索引 3072 个字节;较旧的 COMPACT 和 REDUNDANT 格式允许 767,这正是 VARCHAR(255) in utf8mb4 失败。

常见原因

  • 唯一索引建在 utf8mb4 VARCHAR,尤其是在 MySQL 5.6 或使用旧行格式时。
  • 复合索引的各列加起来超过了上限。

如何修复它

  1. 使用 DYNAMIC 行格式(自 MySQL 5.7 起为默认)。

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. 对列的前缀建立索引,适用于非唯一索引。

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. 如果不需要长值,可以缩窄列宽,例如 VARCHAR(191) 找到一封已建索引的邮件,在 utf8mb4 保持在 767 字节限制以内。

相关错误

更多键和约束错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。