Php artisan migrate执行异常：字段长度与外键未生效问题

问题描述 #

图1为新创建的Laravel迁移表，图2是之前正常创建的迁移表，二者代码逻辑一致，仅属性名称不同，外键设置相同。存在以下疑问：

• 为何图1的字段类型是varchar(191)而非varchar(255)？
• 迁移中设置的外键未生效是什么原因？
• 之前执行过npm build等部署命令，是否是这些操作导致的问题？

迁移代码 #

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('calibrations', function (Blueprint $table) {
            $table->id();
            $table->string('Identification_No');
            $table->foreign('Identification_No')->references('Identification_No')->on('fieldequips');
            $table->string('Calibration_point');
            $table->date('Expired_Date');
            $table->date('Calibration_Date');
            $table->date('Next_Due_Date');
            $table->string('Correction_factor');
            $table->string('Validated_by');
            $table->date('Validated_Date');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('calibrations');
    }
};

问题分析与解决 #

1. 字段长度为varchar(191)的原因

这和数据库字符集配置直接相关：

• Laravel默认使用utf8mb4字符集（支持emoji等4字节字符），而旧版MySQL的索引长度限制为767字节。varchar(191)*4字节=764字节，刚好在限制范围内，所以string()方法默认生成varchar(191)。
• 如果之前的表用的是utf8字符集（每个字符3字节），varchar(255)*3字节=765字节，刚好符合限制，所以是varchar(255)。
• 检查config/database.php中mysql连接的charset和collation配置即可确认字符集设置。此问题和npm build无关。

2. 外键未生效的原因

外键创建生效必须满足以下条件：

• 主表fieldequips的Identification_No字段必须是索引字段（主键、唯一索引或普通索引），无索引则外键无法关联。
• 关联字段的数据类型、长度、字符集必须完全一致。如果主表的Identification_No是varchar(255)，而新表是varchar(191)，长度不匹配会导致外键创建失败。
• 数据库引擎必须是InnoDB（MyISAM不支持外键），需确认表引擎是否为InnoDB。
• 建议显式给字段加索引，避免自动加索引的潜在问题：

  $table->string('Identification_No')->index();
  $table->foreign('Identification_No')->references('Identification_No')->on('fieldequips');
  

3. npm build的影响

npm build是前端资源编译打包命令，仅处理前端静态资源，完全不涉及后端数据库迁移逻辑，不会导致这个问题。

解决步骤 #

1. 查看主表fieldequips的Identification_No字段的类型、长度、索引状态。
2. 调整新表的Identification_No字段长度和主表保持一致，比如改为$table->string('Identification_No', 255)。
3. 确认config/database.php中mysql连接的engine设置为'InnoDB'。
4. 回滚并重新执行迁移：

   php artisan migrate:rollback
   php artisan migrate
   

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