Laravel對不同版本的MySQL字元編碼報錯問題

柳旦旦發表於2021-01-14

Laravel報錯
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long

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 5.3升級到Laravel 5.4,不需要對字元編碼做切換。

解決方案

  1. 升級MySql版本到5.5.3以上。
  2. 手動配置遷移命令migrate生成的預設字串長度,在app\Providers\AppServiceProvider中呼叫Schema::defaultStringLength方法來實現配置:
use Illuminate\Support\Facades\Schema;

/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
   Schema::defaultStringLength(191);
}
本作品採用《CC 協議》,轉載必須註明作者和本文連結
專注細節,慢慢提升自己。✍️

相關文章