Laravel中如何进行软删除操作_Laravel模型SoftDeletes实现与配置【教程】

软删除需同时满足模型使用Softdeletes trait和数据表含deleted_at字段；默认查询自动排除已软删记录，查全部用withTrashed()，仅查已删用onlyTrashed()，restore()恢复，forceDelete()彻底删除。

软删除不是“删不掉”，而是 deleted_at 字段被设为当前时间，让模型自动从常规查询中隐身；没配对 SoftDeletes trait 或漏加数据库字段，就根本不会生效。

如何启用 SoftDeletes 并添加 deleted_at 字段

必须同时满足两个条件：模型使用 trait、数据表含 deleted_at 字段。缺一不可，否则调用 delete() 仍是硬删除。

• 在迁移中添加字段：

  php artisan make:migration add_deleted_at_to_users_table --table=users

  ，然后在 up() 方法里写：

  $table->softDeletes();

• 在模型中引入 trait：

  use IlluminateDatabaseEloquentSoftDeletes;

  并在类定义中声明：

  use SoftDeletes;

• 注意：字段名固定为 deleted_at，不能改；类型必须是 timestamp（softDeletes() 自动处理）

软删除后查询行为的变化

默认所有 Eloquent 查询（User::all()、User::where(...)->get()）自动排除 deleted_at IS NOT NULL 的记录。这是通过全局作用域实现的，无需手动加 whereNull('deleted_at')。

• 查已软删除的数据：用 withTrashed() —— 包含 deleted_at != null 和 null 的记录
• 只查已软删除的数据：用 onlyTrashed() —— 仅 deleted_at IS NOT NULL
• restore() 可恢复单条或集合，它会把 deleted_at 设为 NULL，不是重新插入
• forceDelete() 才是真正从数据库移除（跳过软删除逻辑）

常见踩坑点与兼容性注意

软删除不是魔法，很多地方需要显式干预，否则容易“以为删了，其实还在”或“想查却查不到”。

• 关联查询默认不穿透软删除：比如 User::with('posts') 不会自动过滤掉已软删除的 posts，除非 Post 模型也启用了 SoftDeletes 并在关系定义中加 ->withTrashed()
• 数据库约束冲突：如果表上有 UNIQUE 约束（如邮箱唯一），软删除后重插同邮箱会报错 —— 因为记录物理还在，只是被隐藏了
• 索引建议：给 deleted_at 加索引，尤其当表数据量大且频繁执行 withTrashed() 时，否则全表扫描很慢
• API 返回时别忘了判断：直接 return $user 可能返回已被软删除的模型（比如通过 ID 强查），应主动检查 $user->trashed()

最常被忽略的是：软删除状态不影响模型实例的属性访问，$user->deleted_at 是可读可赋值的，但直接改它不会触发任何钩子或同步状态，必须用 restore() 或 delete() 才行。