前言
大家都知道，我们经常做项目都团队协作开发，每个人都在自己本地的数据库，如果你曾经出现过让同事手动在数据库结构中添加字段的情况，数据库迁移可以解决你这个问题。
不仅如此，在线上部署的时候，也避免了手动导入数据库或手动修改数据结构的麻烦，数据迁移帮你方便的维护着数据结构。
但方便的同时也会伴随着一些问题，下面这篇文章将详细给大家介绍关于Laravel5.4中migrate报错Specified key was too long error的解决方法，下面话不多说了，来一起看看详细的介绍吧。
发现问题
Laravel 5.4默认使用utf8mb4字符编码，而不是之前的utf8编码。因此运行php artisan migrate 会出现如下错误：
|
1
2
3
4
5
|
[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字符集存储。
这也应该就是Laravel 5.4改用4字节长度的utf8mb4字符编码的原因之一。不过要注意的是，只有MySql 5.5.3版本以后才开始支持utf8mb4字符编码（查看版本：selection version();）。如果MySql版本过低，需要进行版本更新。
注：如果是从Laravel 5.3升级到Laravel 5.4，不需要对字符编码做切换。
解决问题
- 升级MySql版本到5.5.3以上。
-
手动配置迁移命令migrate生成的默认字符串长度，在AppServiceProvider中调用
Schema::defaultStringLength方法来实现配置：
|
1
2
3
4
5
6
7
8
9
10
11
|
use Illuminate\\Support\\Facades\\Schema;
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
Schema::defaultStringLength(191);
}
|
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对快网idc的支持。
原文链接：https://segmentfault.com/a/1190000008416200
相关文章
- ASP.NET本地开发时常见的配置错误及解决方法？ 2025-06-10
- ASP.NET自助建站系统的数据库备份与恢复操作指南 2025-06-10
- 个人网站服务器域名解析设置指南：从购买到绑定全流程 2025-06-10
- 个人网站搭建：如何挑选具有弹性扩展能力的服务器？ 2025-06-10
- 个人服务器网站搭建：如何选择适合自己的建站程序或框架？ 2025-06-10
