laravel artisan命令中软删除查询失败的根本原因是：模型未启用softdeletes trait、数据表缺少deleted_at字段、未显式穿透默认作用域；eloquent默认过滤软删记录，需用withtrashed()等方法绕过。
在 Laravel 命令行（Artisan 命令）中执行软删除相关查询时出现“查不到数据”或“restore() 不生效”，根本原因不是环境差异，而是命令上下文里容易忽略三个硬性前提：模型必须启用 SoftDeletes trait、数据表必须存在可空的 deleted_at 字段、所有涉及软删记录的操作都必须显式穿透默认作用域。
查不到软删数据？默认过滤机制在 CLI 中同样生效
无论 Web 请求还是 Artisan 命令，Eloquent 默认都会在所有 SELECT 查询中自动添加 WHERE deleted_at IS NULL。这意味着：
-
User::all()、User::find(1)、User::where('email', 'x@y.z')->first()—— 全部跳过已软删记录 - 必须改用
withTrashed()查全部（含软删），或onlyTrashed()查仅软删 - 错误示例：
php artisan tinker --execute="User::find(123)->restore()"→find()返回 null，调用失败 - 正确写法：
php artisan tinker --execute="User::withTrashed()->find(123)?->restore()"
restore() 静默失败？只因没拿到带 deleted_at 的实例
restore() 是模型实例方法，且只对 deleted_at 非 null 的实例有效。命令行中常见误操作：
- 直接静态调用：
User::restore()→ 报错 “Call to undefined method” - 用
onlyTrashed()->where(...)->first()后调restore()→ 可行，但不触发restoring/restored事件 - 推荐做法：先确保取到完整实例，再调用实例方法
（例如在自定义 Artisan 命令的handle()方法中）
安全恢复单条：
$user = User::withTrashed()->findOrFail($id);<br> $user->restore();
带异常兜底：$user->restoreOrFail(); // 失败时抛 Illuminate\Database\Eloquent\ModelNotFoundException
批量恢复在命令行中要防超时与事务断裂
Artisan 命令生命周期长，适合处理大批量软删恢复，但也需主动控制资源：
- 避免
User::onlyTrashed()->get()->each->restore()—— 全量加载易爆内存 - 改用分片 + 事务封装：
chunkById(200, function ($users) { DB::transaction(fn () => $users->each->restore()); }); - 若需联动更新日志或统计表，务必把
restore()和后续写入包进同一DB::transaction() - 注意：批量
restore()调用（如User::onlyTrashed()->where(...)->restore()）是 SQL UPDATE，不走模型事件，也不校验访问器
调试命令行软删异常的三步定位法
当命令执行结果不符合预期，按顺序检查：
-
查模型：确认
use SoftDeletes;已声明，且未被条件编译或 trait 冲突覆盖 -
查数据库：运行
php artisan tinker后执行DB::select("DESCRIBE users")，确认deleted_at字段存在且类型为timestamp NULL -
查查询逻辑：在命令中临时加日志，输出实际 SQL：
DB::enableQueryLog(); User::withTrashed()->first(); dd(DB::getQueryLog());
