thinkphp6.0中软删除与真实删除共存需模型启用softdelete trait并配置delete_time为null允许字段,软删用destroy()或实例delete(),硬删必须加force参数,恢复须用onlytrashed()查出实例后调用restore()。

在ThinkPHP6.0中实现软删除与真实删除共存,需让同一模型既能执行标记式删除(写delete_time),又能触发物理清除(删行),且恢复操作只作用于软删记录、不误触已硬删数据。这要求模型配置、字段约束、调用路径三者严格隔离。
模型启用软删除并兼容真实删除
在模型类顶部引入SoftDelete trait,并显式声明软删字段名。
use think\model\concern\SoftDelete;
class UserModel extends Model { use SoftDelete; protected $deleteTime = 'delete_time'; }
【delete_time字段必须定义为DATETIME NULL或BIGINT UNSIGNED NULL】,不能带NOT NULL、DEFAULT CURRENT_TIMESTAMP或自动更新约束,否则软删时写入失败却无报错,真实删除时也因字段异常被拦截。
TP6.0中无需设置$useSoftDelete = true,但若模型继承自自定义基类,需确认基类未覆盖或禁用SoftDelete行为。
区分调用路径:软删走模型,硬删加force标记
软删除必须通过模型方法触发:
UserModel::destroy(123) → 写delete_time,不删行
UserModel::find(456)->delete() → 同样只更新delete_time
真实删除必须显式携带force参数或调用force()链式方法:
UserModel::destroy(789, true) → 绕过软删逻辑,直接DELETE FROM
UserModel::find(101)->force()->delete() → 先加载再强制物理删
⚠️ 注意:UserModel::where('id', 123)->delete() 是Db层直删,跳过模型所有逻辑,既不触发软删也不走force校验,【会导致事件丢失、关联未清理、日志断链】,禁止在业务中使用。
安全恢复软删数据(避开静默失败)
第一步:用onlyTrashed()前置定位,确保查的是真软删记录
$user = UserModel::onlyTrashed()->find(202);
第二步:判空再调用,避免对null对象执行restore()
if ($user) { $result = $user->restore(); }
第三步:检查返回值,false代表失败但不抛异常
if (false === $result) { // 进入字段类型、NULL权限、模型启用状态排查流程 }
restore()是实例方法,【UserModel::where('id', 202)->restore()会直接报Call to undefined method错误】,不可静态调用或链式挂载在where后。
批量恢复软删记录(按条件筛选)
方法一:Db直写UPDATE(快,无事件)
Db::name('user')->whereNotNull('delete_time')->where('status', 1)->update(['delete_time' => null]);
方法二:模型分块+逐条restore(带事件,可校验)
UserModel::onlyTrashed()->where('status', 1)->chunk(300, function ($users) { $users->each(function ($u) { if (false === $u->restore()) { // 记录失败ID并告警 } }); });
⚠️ 注意:UserModel::onlyTrashed()->where('status', 1)->restore() 无效——restore()不接受查询构造器链式结果,只对已加载的模型实例生效。
验证恢复结果是否可见
恢复成功后,该记录仍不会出现在默认查询中,因为框架默认自动添加 delete_time IS NULL 条件。
要看到刚恢复的数据,必须重新执行常规查询:
$fresh = UserModel::find(202); // 此时能查到
或查列表时不用any特殊方法:
$list = UserModel::select(); // 恢复后的记录自然包含在内
若仍查不到,说明restore()未真正清空delete_time字段,应立即检查数据库该字段当前值是否仍为非NULL时间戳。











