laravel引发的MySQL数据库报错1071 Specified key was too long; max key length is 1000 bytes

最新推荐文章于 2024-06-11 12:44:55 发布

原创最新推荐文章于 2024-06-11 12:44:55 发布 · 1.2k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#laravel #migrate #mysql #utf8 #字符集

PHP编程专栏收录该内容

9 篇文章

订阅专栏

当在Laravel中执行迁移操作时，可能会遇到由于键长超过限制导致的错误。本文详细解释了这一问题的原因，特别是在使用包含宽字符如Emoji的utf8编码时。文章提供了具体的解决方案，通过在AppServiceProvider中调整Schema::defaultStringLength方法来避免错误。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在运行laravel的migrate时候产生报错如下：

 SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 1000 bytes (SQL: alter table `use
  rs` add unique `users_email_unique`(`email`))

MySql支持的utf8编码最大字符长度为3字节，如果遇到4字节的宽字符就会出现插入异常。三个字节UTF-8最大能编码的Unicode字符是0xffff，即Unicode中的基本多文种平面（BMP）。因而包括Emoji表情（Emoji是一种特殊的Unicode编码）在内的非基本多文种平面的Unicode字符都无法使用MySql的utf8字符集存储。

解决方法：

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

<?php

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

    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}