laravel5.5 Syntax error or access violation: 1071 Specified key was too long

Posted 2020-10-10 周伯通的麦田

 

在laravel5.5执行数据迁移时

php artisan migrate

先说下系统环境：

ubutun Ubuntu 16.04.3 LTS

mysql:5.6.35-log

经查自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 5.3升级到Laravel 5.4，不需要对字符编码做切换。

解决问题

1. 升级MySql版本到5.5.3以上。

2. laravel默认了1071，而报错中看出数据库设置了最大是767，所以就报错了

   Laravel 5.4默认使用utf8mb4字符编码，而不是之前的utf8编码。mb4的最大字符长度为4个字节，解决方法是：

   手动配置迁移命令migrate生成的默认字符串长度，在AppServiceProvider中调用Schema::defaultStringLength方法来实现配置：

再次执行 :php artisan migrate

好像这错误不同了。。经查貌似是Mysql执行安全模式检查的问题，laravel的config/database.php 的mysql选项配置了严格模式默认为true,修改为：

 再次执行后：

OK。。完毕..