软删除是用标记字段(如deleted_at)替代物理删除,恢复即重置该标记;所有读写操作必须显式过滤deleted_at IS NULL,否则导致数据错乱。

软删除必须用 UPDATE,不能用 DELETE
执行 DELETE FROM user WHERE id = 123 后,数据在 InnoDB 中从页中被物理移除,后续只能靠 binlog 或备份恢复——这已经不属于软删除范畴。正确做法是建表时预留字段:deleted_at TIMESTAMP NULL 或 is_deleted TINYINT(1) DEFAULT 0,然后统一走:UPDATE user SET deleted_at = NOW() WHERE id = 123UPDATE user SET is_deleted = 1 WHERE id = 123
注意:deleted_at 比布尔型更实用(能查时间、支持按保留期清理、不干扰唯一索引),但千万别设 DEFAULT CURRENT_TIMESTAMP,否则新插入记录默认就是“已删除”。
所有查询必须显式过滤 deleted_at IS NULL
漏加过滤条件会导致:列表总数 120 条,点进去只剩 115 条;后台统计虚高;导出数据含已删客户……这不是 BUG,是必然结果。
常见踩坑点:
• 基础查询一律加 WHERE deleted_at IS NULL,建议封装成视图(如 v_user_active)或 ORM 全局作用域
• JOIN 时不能只写 ON u.id = o.user_id,必须补上状态过滤:LEFT JOIN order o ON u.id = o.user_id AND o.deleted_at IS NULL
• 聚合统计别偷懒写 COUNT(*),要用 COUNT(CASE WHEN deleted_at IS NULL THEN 1 END) 或先 WHERE deleted_at IS NULL 再计数
• 给 deleted_at 单独建索引,否则 IS NULL 查询可能全表扫描(尤其大表)
恢复就是 UPDATE 回 NULL 或 0,但得看场景
单条恢复:UPDATE user SET deleted_at = NULL WHERE id = 123
批量恢复:UPDATE user SET deleted_at = NULL WHERE id IN (123, 456, 789)
按时间范围恢复:UPDATE user SET deleted_at = NULL WHERE deleted_at >= '2026-08-01' AND deleted_at <br>但要注意:<br>• 关联表必须同步处理,比如订单主表恢复了,订单明细表的 <code>deleted_at 也得一起置空,否则详情页显示为空
• 手动写 SQL 容易漏条件,例如只写 WHERE id = 123 没加 AND deleted_at IS NOT NULL,可能误改正常数据
• 如果表有唯一约束(如邮箱字段),恢复前需确认该值未被新注册用户占用,否则 UPDATE 会因唯一键冲突失败
TP6.0 等框架里 restore() 失效的三个硬性前提
调用 restore() 没反应、数据库字段没变,大概率卡在这三点:
• 模型类里是否同时满足:引入 use think\model\concern\SoftDelete、声明 use SoftDelete、定义 protected $deleteTime = 'delete_time'
• ThinkPHP 6.0.7 及更早版本,还必须显式设置 protected $useSoftDelete = true(6.0.8+ 可省略,但写上更稳)
• 执行过 php think optimize:schema 刷新模型缓存,否则旧配置不生效
另外,数据库字段定义必须是 DATETIME NULL DEFAULT NULL,如果 Null 列为 NO 或默认值是 '1970-01-01',框架尝试写入 NULL 会被 MySQL 拒绝,而 PHP 层捕获不到错误,restore() 就会静默失败。
UPDATE,而是确保它出现在所有该出现的地方——查询、关联、统计、索引、框架配置、字段定义、事务边界。少一个环节,软删除就从保护机制变成数据污染源。



















