如何解决Laravel外键约束违反错误（SQLSTATE[23000]）

我创建了两个Laravel迁移文件，第一个执行正常，但第二个出现如下错误：

SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or update a child row: a foreign key constraint fails

不确定外键配置哪里存在问题，请求帮忙排查。

第一个迁移Schema： #

Schema::create('cryptocurrencies', function (Blueprint $table) {
    $table->id('id');
    $table->string('name');
    $table->string('symbol')->unique();
    $table->string('slug');
    $table->longtext('description');
});

第二个迁移Schema： #

Schema::create('cryptocurrencies_quotes', function (Blueprint $table) {
    $table->id('id');
    $table->string('name');
    $table->string('symbol');
    $table->string('slug');
    $table->integer('cryptocurrency_id');
    $table->bigInteger('circulating_supply');
    $table->bigInteger('total_supply');
    $table->double('price');
    $table->double('volume_24h');
    $table->timestamps();
});

Schema::table('cryptocurrencies_quotes', function (Blueprint $table) {
    $table->foreign('cryptocurrency_id')->references('id')->on('cryptocurrencies')->onUpdate('cascade')->onDelete('cascade');
});

问题排查及解决方法 #

• 字段类型不匹配：cryptocurrencies表的id是bigint（Laravel的$table->id()默认生成bigint类型），但cryptocurrencies_quotes表的cryptocurrency_id用的是integer，类型不一致会导致外键约束失败。修改方式：

  // 替换原integer字段定义
  $table->unsignedBigInteger('cryptocurrency_id');
  // 或者用Laravel简化写法，自动关联主键并添加外键约束
  $table->foreignId('cryptocurrency_id')->constrained('cryptocurrencies')->onUpdate('cascade')->onDelete('cascade');
  

  用foreignId写法可以省略后续单独添加外键的代码，更简洁规范。

• 迁移执行顺序错误：检查两个迁移文件的文件名前缀时间戳，确保cryptocurrencies的迁移文件时间戳更早，这样主表会先被创建，否则创建外键时主表不存在会触发错误。

• 已有数据冲突：如果cryptocurrencies_quotes表中已存在数据，且其中cryptocurrency_id的值在cryptocurrencies表中找不到对应记录，添加外键时会触发约束失败。可以先清空子表数据，或者确保所有cryptocurrency_id都能在主表找到匹配项。

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