Laravel 5.*默认使用utf8mb4
字符编码,而不是之前的utf8
编码。因此运行php artisan migrate
会出现如下错误:
[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
字符集存储。
这也应该就是Laravel 5.*改用4字节长度的utf8mb4
字符编码的原因之一。不过要注意的是,只有MySql 5.5.3版本以后才开始支持utf8mb4
字符编码(查看版本:select version();
)。如果MySql版本过低,需要进行版本更新。
解决方法一:
- 升级MySql版本到5.5.3以上。
手动配置迁移命令
migrate
生成的默认字符串长度,在AppServiceProvider
中调用Schema::defaultStringLength
方法来实现配置:use Illuminate\Support\Facades\Schema; public function boot() { Schema::defaultStringLength(191); }
解决方法一:
config/database.php文件中 msql配置信息修改 chartset,collation
'mysql' => [ 'driver' => 'mysql', 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '3306'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'unix_socket' => env('DB_SOCKET', ''), // 'charset' => 'utf8mb4', //修改前 // 'collation' => 'utf8mb4_unicode_ci', //修改前 'charset' => 'utf8',//修改后 'collation' => 'utf8_unicode_ci',//修改后 'prefix' => '', 'strict' => true, 'engine' => null, ],