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时间戳。
