Laravel迁移文件中解决#1071复合索引长度超限问题

嘿，这个问题我太熟悉了——MySQL的#1071错误本质就是复合索引的总字节数超过了1000字节的限制，尤其是当你用utf8mb4编码时，每个字符占4字节，很容易触发这个问题。既然你没法直接操作MySQL，得通过Laravel迁移来调整，那咱们直接上解决方案：

核心思路 #

你的目标索引是通过指定部分列的长度来控制总字节数：KEY index (parent_menu_id,menu_link(50),plugin(50),alias(50))，在Laravel迁移里可以通过原生SQL语句或者rawIndex方法来实现，因为Laravel的Schema Builder默认不支持直接在索引中指定列的截断长度。

步骤1：处理旧索引（如果存在） #

如果之前已经创建过同名的复合索引，先在迁移的up方法里删掉它：

Schema::table('menus', function (Blueprint $table) {
    // 方式一：通过索引名删除
    $table->dropIndex('index');
    // 方式二：通过列数组定位删除（更稳妥，避免索引名记错）
    // $table->dropIndex(['parent_menu_id', 'menu_link', 'plugin', 'alias']);
});

步骤2：添加指定列长度的复合索引 #

有两种方式可以实现你的目标索引：

方式一：直接用原生SQL语句（最直观）

用DB::statement执行你需要的索引创建语句，完全贴合你给出的目标索引定义：

// 在迁移的up方法中添加
DB::statement('ALTER TABLE menus ADD KEY `index` (`parent_menu_id`,`menu_link`(50),`plugin`(50),`alias`(50))');

方式二：使用Laravel的rawIndex方法（更贴合框架语法）

如果你想尽量用Laravel的Schema风格，可以用rawIndex传递原生的索引列定义：

Schema::create('menus', function (Blueprint $table) {
    $table->id();
    $table->unsignedBigInteger('parent_menu_id');
    $table->string('menu_link'); // 业务需要保留长内容的话，不用修改列本身长度
    $table->string('plugin');
    $table->string('alias');
    
    // 第一个参数是原生列定义，第二个是索引名
    $table->rawIndex('`parent_menu_id`,`menu_link`(50),`plugin`(50),`alias`(50)', 'index');
});

为什么这样能解决问题？ #

咱们算个字节账：假设你的表用utf8mb4编码（每个字符占4字节），menu_link(50)就是50×4=200字节，三个这类列加起来是600字节，再加上parent_menu_id（bigint类型占8字节），总索引长度才608字节，远低于MySQL的1000字节限制，自然就不会触发#1071错误了。

额外提醒 #

• 如果业务允许，也可以直接修改列的默认长度，比如把$table->string('menu_link')改成$table->string('menu_link', 50)，这样索引不用截断也能控制长度，但如果需要列存储更长的内容，还是在索引里截断更合适。
• 确保索引名index在表中是唯一的，避免重复创建报错。

内容的提问来源于stack exchange，提问作者Imran Farooq