关于1071 – Specified key was too long; max key length is 767 bytes错误的原因

mysql数据库里某个UNIQUE唯一索引字段从utf8改为utf8mb4时提示1071 - Specified key was too long; max key length is 767 bytes,来看看这个错误的来原因。

来几个知识点

  • 一个字符latin1占用1 bytesutf8占用3 bytes,而utf8mb4占用4 bytes
  • mysql5.6以及以前的版本的InnoDB引擎的表限制索引最多占用767 bytes;而MyISAM的是最长1000 bytes
  • mysql5.7版本开始这个限制提升到3072 bytesUTF8可以达到VARCHAR(1024)

所以当你的唯一索引字段在mysql5.6或更早的版本时(引擎为InnoDB),utf8mb4字符串最长能到VARCHAR(191)(191*4=764),utf8可以到VARCHAR(255)(255*·3=765)。如果你从不指定长度直接使用utf8mb4字段做唯一索引,就会报Specified key was too long; max key length is 767 bytes错误,因为计算默认字符串默认长度时是255。

这个问题在Laravel中就有可能发生,为了存储emoji它默认使用utf8mb4,如果你的mysql版本低于5.7,就需要手动配置数据迁移生成的字符串默认长度,在 AppServiceProvider中调用 Schema::defaultStringLength 方法来配置它 :

use Illuminate\Support\Facades\Schema;

/**
 * 引导任何应用程序服务。
 *
 * @return void
 */
public function boot()
{
    Schema::defaultStringLength(191);
}

参考:

  1. https://stackoverflow.com/questions/1814532/1071-specified-key-was-too-long-max-key-length-is-767-bytes
  2. https://laravel-china.org/topics/14723/the-latest-modification-plan-prompts-specified-key-was-too-long-to-solve-it
阿里云服务器2折起,低至293/年

发表评论

电子邮件地址不会被公开。 必填项已用*标注