ThinkPHP软删恢复失败主因是delete_time字段配置错误或类型不匹配，导致restore()静默失效；须确保字段为NULLABLE的DATETIME/TIMESTAMP、显式声明软删配置，并用update直接设NULL批量恢复。
软删字段没设对，restore() 会静默失败
ThinkPHP 的软删依赖模型里 delete_time 字段（默认名），但很多人直接用 softDelete() 没配字段，或数据库里字段类型是 VARCHAR、INT 却没设成 NULL 允许值。结果调 restore() 时没报错，数据却始终查不到——因为底层 SQL 是 WHERE delete_time IS NULL，而你的字段存的是 '0' 或 0，根本匹配不上。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认模型中已显式声明软删字段：
protected $softDelete = ['field' => 'delete_time', 'format' => 'datetime']; - 数据库字段必须是
DATETIME或TIMESTAMP类型，且允许NULL - 如果历史数据里
delete_time存的是0或'0000-00-00 00:00:00'，先用 SQL 批量转成NULL：UPDATE table_name SET delete_time = NULL WHERE delete_time = '0000-00-00 00:00:00';
批量恢复要绕开 restore() 的单条限制
restore() 默认只作用于当前模型实例，传 ID 数组进去不会生效；想批量恢复，得手动拼条件 + saveAll() 或原生查询。否则容易写成循环调 restore()，N 条 SQL，性能崩，事务也难控。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
Db::name('table')->where('id', 'in', [1,2,3])->update(['delete_time' => null]);最直接 - 如果必须走模型逻辑（比如要触发事件），先查出对象集合再批量更新：
$models = User::onlyTrashed()->whereIn('id', [1,2,3])->select(); foreach ($models as $m) { $m->delete_time = null; } User::saveAll($models); - 注意：模型的
saveAll()不会自动跳过软删状态，所以必须显式赋值delete_time => null，不能只调restore()
误删后查不到数据？先确认是否真在回收站里
ThinkPHP 的“软删”不是把数据挪到另一张表，而是靠 delete_time 标记。所以 select() 默认不查已软删记录，onlyTrashed() 才能捞出来。很多人执行了 delete()，回头用 find() 查不到，就以为数据丢了，其实只是没切到回收站视图。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 查软删数据必须加
onlyTrashed()：User::onlyTrashed()->where('id', 123)->find(); - 恢复前建议先验证存在性：
User::onlyTrashed()->where('id', 123)->value('id')返回非 null 才继续 - 别依赖
withTrashed()做恢复操作——它只是查的时候包含软删记录，restore()仍需单独调用
事务里恢复软删数据，记得检查 delete_time 是否被自动填充
有些模型开启了自动时间戳（createTime/updateTime），而 delete_time 又被 TP 自动识别为软删字段。在事务中调 restore() 后再 save()，可能触发 updateTime 更新，甚至意外重写 delete_time ——尤其当 softDelete 配置里 format 和模型时间格式不一致时。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 恢复操作尽量原子化：直接
update字段，避免走完整save()流程 - 若必须用模型，临时关闭时间自动写入：
User::disableTimestamps();再操作 - 测试时用
getLastSql()看生成的 SQL，确认没有多余的delete_time = NOW()或update_time = ...
