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);
    }
}

究其原因，還是MySQL版本太低了，如果是MySQL5.7.7及以上版本，就沒有上面的問題啦，也不需要手動配置遷移命令migrate生成的默認字符串長度。
原文鏈接: Laravel migrate時報錯: Syntax error or access violation: 1071 Specified key was too long