Laravel 5.4默認使用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改用4字節長度的utf8mb4
字符編碼的原因之一。不過要注意的是,只有MySql 5.5.3版本以后才開始支持utf8mb4
字符編碼(查看版本:select version();
)。如果MySql版本過低,需要進行版本更新。
注:如果是從Laravel 5.3升級到Laravel 5.4,不需要對字符編碼做切換。
解決問題
- 升級MySql版本到5.5.3以上。
-
手動配置遷移命令
migrate
生成的默認字符串長度,在AppServiceProvider
中調用Schema::defaultStringLength
方法來實現配置:use Illuminate\Support\Facades\Schema; public function boot() { Schema::defaultStringLength(191); }