Laravel Eloquent模型Delete on cascade级联删除报错问题咨询

报错原因排查 #

1. 外键约束冲突报错 #

报错详情：

SQLSTATE[23000]: [Microsoft][ODBC Driver 17 for SQL Server][SQL Server] The DELETE statement conflicted with the REFERENCE constraint "FK_Interests_Properties_User". The conflict occurred in database "CADASTRO", table "dbo.Interests_Properties", column 'interests_user_id'. (SQL: delete from [Interests_User] where [user_id] = 1515626)
原因：
Interests_User是主表，Interests_Properties是从表，从表的interests_user_id字段关联了主表的id字段，存在外键约束。直接删除主表记录时，从表还有对应的关联数据，数据库会触发约束拦截删除操作。另外原代码的关联关系定义错误，未正确实现关联数据预加载和删除。

2. Call to undefined method Illuminate\Database\Eloquent\Builder::foreign()报错 #

原因：

• 关联方法未加return：properties方法中定义关联时没有返回关联对象，调用关联时返回的是查询构造器，无法正确解析关联操作。
• 关联类型使用错误：两个表是一对多关系（一个用户兴趣对应多个兴趣属性），原代码错误使用了多对多关联的belongsToMany方法，且第二个参数错误传入了'foreign_key'字符串，导致框架解析关联时调用不存在的方法。
• 删除逻辑错误：get()方法返回的是模型集合，不能直接调用集合的properties属性，需要遍历集合中的每个模型实例再操作关联。

正确实现级联删除方案 #

方案1：Eloquent 层面手动实现级联删除（可触发模型事件） #

第一步：修正模型关联定义

修改InterestsUser.php中的properties方法：

public function properties()
{
    // 一对多关联：外键为Interests_Properties的interests_user_id，关联主表id字段
    return $this->hasMany(InterestsProperties::class, 'interests_user_id', 'id');
}

第二步：修正删除逻辑

修改lgpdInterestsUser方法中的删除分支代码：

} elseif ($action == 'delete') {
    $userInterests = InterestsUser::with('properties')->where('user_id', $id_user)->get();
    if ($userInterests->isEmpty()) {
        return 'Not Found.';
    }
    foreach ($userInterests as $userInterest) {
        // 先删除关联的属性记录
        $userInterest->properties()->delete();
        // 再删除主表记录
        $userInterest->delete();
    }
    return 'Success Remove.';
}

方案2：数据库层面实现级联删除（性能更高） #

直接在Interests_Properties表的迁移文件中对外键添加级联删除属性，删除主表记录时数据库会自动删除对应的从表关联数据，无需在代码中手动处理关联删除：

Schema::create('Interests_Properties', function (Blueprint $table) {
    $table->id();
    $table->unsignedBigInteger('interests_user_id');
    $table->string('key');
    $table->string('value');
    $table->timestamps();

    // 定义外键并添加级联删除
    $table->foreign('interests_user_id')
          ->references('id')
          ->on('Interests_User')
          ->onDelete('cascade');
});

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