laravel报错1071 Specified key was too long; max key length is 1000 bytes

时间 2019-12-14

标签 laravel 报错 specified key long max length bytes 繁體版

原文原文链接

Laravel 默认使用utf8mb4字符编码，而不是的utf8编码。所以运行php artisan migrate会出现以下错误：php

[Illuminate\Database\QueryException]
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes (SQL: alter table users add unique users_email_unique(email))
[PDOException]
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

问题根源

MySql支持的utf8编码最大字符长度为3字节，若是遇到4字节的宽字符就会出现插入异常。三个字节UTF-8最大能编码的Unicode字符是0xffff，即Unicode中的基本多文种平面（BMP）。于是包括Emoji表情（Emoji是一种特殊的Unicode编码）在内的非基本多文种平面的Unicode字符都没法使用MySql的utf8字符集存储。ide

这也应该就是Laravel改用4字节长度的utf8mb4字符编码的缘由之一。不过要注意的是，只有MySql 5.5.3版本之后才开始支持utf8mb4字符编码（查看版本：selection version();）。若是MySql版本太低，须要进行版本更新。编码

解决问题

1.首先确保MySql版本在5.5.3以上spa

2.手动配置迁移命令migrate生成的默认字符串长度，在AppServiceProvider文件的boot方法调用Schema::defaultStringLength方法来实现配置：code

public function boot()
{
    //设置默认字符串长度
    Schema::defaultStringLength(191);
}