laravel migrate時報錯:Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes
今天在學習laravel的路由模型繫結時,在按照文件執行php artisan migrate
時報錯。
In Connection.php line 664: 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`) ) In Connection.php line 458: SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes
原來,Laravel 5.4+預設使用utf8mb4字元編碼,而不是之前的utf8編碼。因此在執行php artisan migrate 會報出錯誤。
問題根源
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字元編碼(檢視版本:selection version();)。如果MySql版本過低,需要進行版本更新。
Laravel同樣也可以手動配置遷移生成的預設字串長度:
如果你正在執行的 MySQL release 版本低於5.7.7 或 MariaDB release 版本低於10.2.2 ,為了MySQL為它們建立索引,你可能需要手動配置遷移生成的預設字串長度,你可以通過呼叫 AppServiceProvider 中的 Schema::defaultStringLength 方法來配置它,或者你可以為資料庫開啟 innodb_large_prefix 選項,有關如何正確開啟此選項的說明請查閱資料庫文件。
解決辦法
1.MySQL版本升級至5.5.3以上
2.手動配置遷移命令migrate生成的預設字串長度,在AppServiceProvider中呼叫Schema::defaultStringLength方法來實現配置(如果MySQL版本大於5.7.7就無需配置了):
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Schema;
class AppServiceProvider extends ServiceProvider
{
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
Schema::defaultStringLength(191);
}
}
原文連結: Laravel migrate時報錯: Syntax error or access violation: 1071 Specified key was too long