1. 程式人生 > >laravel migrate時報錯:Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

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