Laravel删除模型时清空关联外键保留关联数据的实现方法

首先明确操作报错的核心原因：

• 直接删除用户触发SQLSTATE[23000]外键约束错误，是因为关联表/中间表存在指向当前用户ID的外键记录，数据库层面阻止了删除操作
• detach()/dissociate()方法仅支持特定关联类型：detach()用于多对多BelongsToMany关联，dissociate()用于BelongsTo关联，HasMany类型关联本身没有这两个方法，所以会报方法不存在错误
• 你提到的Type(BelongsTo)关联不需要额外处理：这类关联的外键存储在users表本身，删除用户记录时外键会随记录一同删除，不会在关联的Type表中残留指向用户的数据。

统一封装实现（无需逐关联手写更新逻辑） #

不需要在每次删除用户时逐行写外键更新代码，可以通过模型事件在User模型内部统一封装处理逻辑，一次配置后全局生效，后续删除用户仅需正常调用delete()即可。

1. 首先在User模型中定义需要清空关联关系的属性，列出所有需要处理的关联名：

/**
 * 删除用户时需要清空关联痕迹的关联列表
 * @var array<string>
 */
protected $nullOnDelete = [
    'actions', // HasMany 一对多关联
    'roles', // BelongsToMany 多对多关联
];

2. 在模型的booted方法中注册deleting事件，自动遍历关联列表，根据关联类型执行对应清空逻辑，无需硬编码外键字段名：

protected static function booted()
{
    static::deleting(function (self $user) {
        foreach ($user->nullOnDelete as $relation) {
            $relationInstance = $user->$relation();
            $relationType = class_basename($relationInstance::class);

            match ($relationType) {
                // 多对多关联：直接删除中间表关联记录
                'BelongsToMany' => $relationInstance->detach(),
                // 一对多/一对一关联：将关联表外键置为null
                'HasMany', 'HasOne' => $relationInstance->update([
                    $relationInstance->getForeignKeyName() => null
                ]),
                default => null
            };
        }
    });
}

封装完成后，业务代码中直接执行删除即可，不需要额外处理关联：

$user = User::findOrFail($id);
$user->delete(); // 自动清空所有配置的关联痕迹，不会触发外键约束错误

数据库层面优化（可选，性能更好） #

如果可以调整项目的数据库外键配置，推荐给对应外键添加ON DELETE SET NULL约束，由数据库层面自动完成外键置空逻辑，不需要PHP执行额外的更新查询，性能更高，也能避免代码漏处理导致的报错。
对应的迁移代码示例：

Schema::table('user_actions', function (Blueprint $table) {
    // 先删除原有外键
    $table->dropForeign(['id_user']);
    // 重建外键，设置删除用户时自动将外键置为null
    $table->foreign('id_user')
        ->references('id')->on('users')
        ->onDelete('set null');
});

// 多对多中间表的外键可以设置为ON DELETE CASCADE
// 删除用户时自动删除中间表关联记录，不会影响关联的角色本身数据
Schema::table('role_user', function (Blueprint $table) {
    $table->dropForeign(['user_id']);
    $table->foreign('user_id')
        ->references('id')->on('users')
        ->onDelete('cascade');
});

注意：使用ON DELETE SET NULL约束前，需要确保关联表的外键字段已经设置为nullable()，否则会触发数据库字段非空报错。

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