ThinkPHP软删除失效主因是删除时间字段配置错误：需确保数据库字段为可空DATETIME/TIMESTAMP类型、模型中正确引入SoftDelete trait并设置$deleteTime属性、避免自动时间戳干扰、验证查询过滤与删除写入逻辑、清除运行时缓存。
如果您在ThinkPHP中启用软删除功能，但数据未被标记为已删除或查询时无法正确过滤，则很可能是删除时间字段配置不正确。以下是完成该配置的步骤：
一、数据库字段命名与类型设置
删除时间字段必须与模型中声明的字段名完全一致，且类型必须为可为空的DATETIME或TIMESTAMP，不能使用INT类型存储时间戳，否则框架内部比对逻辑会失效。
1、在数据库中添加字段，SQL语句如下：
ALTER TABLE `user` ADD `delete_time` DATETIME NULL DEFAULT NULL;
2、若使用迁移工具，应避免Laravel风格的$table->softDeletes()写法，ThinkPHP 6不支持该语法。
立即学习“PHP免费学习笔记（深入）”；
3、确保该字段未设置NOT NULL约束，否则新增记录时因无默认值将导致插入失败。
二、模型中启用SoftDelete并指定字段
模型需显式引入SoftDelete trait，并通过属性明确告知框架软删除字段名称；若字段名非默认delete_time，必须覆盖$deleteTime属性，否则配置无效。
1、在模型类头部引入trait：
use think\model\concern\SoftDelete;
2、在模型类定义中加入use SoftDelete;声明：
3、设置软删除字段名：
protected $deleteTime = 'delete_time';
4、若字段名为is_deleted，则必须同时配置类型转换，否则写入时会被当作字符串处理，查出值永远不为NULL：
protected $deleteTime = 'is_deleted';
protected $type = ['is_deleted' => 'integer'];
三、避免自动时间戳干扰
软删除字段不参与自动时间戳写入逻辑，若模型开启了$autoWriteTimestamp，又未排除delete_time字段，则新增/更新操作会提前写入当前时间，导致刚插入的数据立即被视为已删除。
1、确认模型中未将delete_time列入$createTime或$updateTime属性；
2、不要在$type或$dateFormat中强行将delete_time设为'datetime'并开启自动写入；
3、正确的做法是保持$deleteTime字段在新增时不被赋值，仅由delete()方法在执行时写入。
四、验证字段是否生效
配置完成后需验证框架是否真正识别该字段：调用模型查询时应自动追加WHERE delete_time IS NULL条件；执行delete()后，数据库对应记录的delete_time字段应被写入当前时间，而非被物理删除。
1、执行一条软删除操作：
$user = UserModel::find(1);
$user->delete();
2、检查数据库中该记录的delete_time字段值是否已更新为当前时间；
3、再次执行UserModel::find(1)，返回结果应为NULL；
4、执行UserModel::withTrashed()->find(1)，应能查出该记录，说明软删除字段已被识别且查询过滤机制正常工作。
五、清除运行时缓存强制重载结构
若修改了已有数据表结构（如新增delete_time字段），框架可能因缓存旧表结构而无法识别新字段，导致软删除始终不触发。
1、删除runtime/cache/目录下的全部文件；
2、删除runtime/model/目录下对应模型的缓存文件；
3、重启Web服务或至少刷新一次页面以重建模型结构缓存；
4、重新执行验证步骤，确认delete_time字段在查询构造中被正确引用。
