Laravel 5.4 migrate時報錯: Specified key was too long error

Laravel 5.4默認使用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字符集存儲。mysql

這也應該就是Laravel 5.4改用4字節長度的utf8mb4字符編碼的緣由之一。不過要注意的是,只有MySql 5.5.3版本之後纔開始支持utf8mb4字符編碼(查看版本:select version();)。若是MySql版本太低,須要進行版本更新sql

注:若是是從Laravel 5.3升級到Laravel 5.4,不須要對字符編碼作切換。ide

解決問題

  1. 升級MySql版本到5.5.3以上。
  2. 手動配置遷移命令migrate生成的默認字符串長度,在AppServiceProvider中調用Schema::defaultStringLength方法來實現配置:編碼

    use Illuminate\Support\Facades\Schema;
    
        public function boot()
        {
           Schema::defaultStringLength(191);
        }
相關文章
相關標籤/搜索