Laravel提示：SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes错误

laravel 默认的数据库字符集为utf8mb4。如果你运行MySQL v5.7.7或者更高版本，则无需做任何修改，但是如果运行的MySQL版本低于v5.7.7，那么在运行migrations命令时，可能会碰到下面这个错误：

[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))
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes

我们可以在 app\Providers\AppServiceProvider.php 文件里中的 boot 方法里设置一个默认值来解决这个错误：

Schema::defaultStringLength(191);

完整的AppServerProvider.php文件代码如下：

<?php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Schema;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Schema::defaultStringLength(191);
    }

    public function register()
    {
        //
    }
}

说明：异常中明确指明最大长度是767字节，utf8mb4编码每字符使用4字节，所以 767 / 4 = 191.75，所以将 string 的默认长度设置为191字符即可。

以上方法也是 Laravel 官方文档给出的解决方案，但是这并没有考虑 utf8mb4 编码下的多列索引。mysql 索引最大长度是 1000 字节。而多列索引，最少由两个字段组成，那么每个字段的最大长度应为500 字节，如果采用 utf8mb4 编码，则每个字符需要 4 个字节存储，那么字符串最大长度应为 125，如果你的迁移中包含多列索引，那么上面的代码（191）仍然会报错，修改成 125 长度完美解决。

Schema::defaultStringLength(125);