GORM软删除实现方法详解

GORM的软删除并非真正删除数据，而是通过精准控制`*time.Time`类型的`DeletedAt`字段实现逻辑标记，其核心在于类型约束、方法调用顺序与查询链路的协同——`Delete()`自动更新时间戳，`Unscoped().Delete()`才执行物理删除；默认查询自动过滤已软删记录，而关联预加载则不会递归过滤，需手动干预；看似简单的功能背后，字段定义错误、`Unscoped()`滥用、关联逻辑遗漏或统计口径偏差，都可能引发数据“消失”、清理失效、查询失真甚至外键崩坏，生产环境更推荐结合标记位与定时批处理来规避风险。

软删除不是删数据，是改 DeletedAt 字段

GORM 的软删除本质就是把 DeletedAt 字段设成当前时间，而不是发 DELETE FROM 语句。它不靠你手动加条件、写钩子或改 SQL，只依赖字段类型和调用方式。

• DeletedAt 必须是 *time.Time（指针类型），不能是 time.Time（值类型）——否则零值 0001-01-01 会被误判为“已删除”，新插入的记录直接查不到
• 最省事的做法是嵌入 gorm.Model，它自带 ID、CreatedAt、UpdatedAt 和正确类型的 DeletedAt
• 自己定义字段时，必须显式加上 gorm:"index"，否则 Unscoped() 外的查询可能因索引缺失而跳过该行
• 别手写 user.DeletedAt = time.Now() —— GORM 不识别这种“手工软删”，后续查询仍可能命中，且不会触发 BeforeDelete 钩子

Delete() 默认软删，Unscoped().Delete() 才真删

调 db.Delete(&user) 不会删库，只会更新 DeletedAt；想物理删除，必须组合 Unscoped()。很多人在迁移脚本或清理逻辑里漏掉 Unscoped()，结果表越跑越大。

• 软删：db.Delete(&user) → 生成 UPDATE ... SET deleted_at = ?
• 硬删：db.Unscoped().Delete(&user) → 生成 DELETE FROM ...，行从数据库物理消失
• 批量操作同理：db.Where("status = ?", "draft").Delete(&Post{}) 是软删；漏了 Unscoped() 就永远删不掉
• Unscoped() 是链式方法，必须放在最前面，比如 db.Unscoped().Where(...).Find(&users)，放后面无效

查不到软删数据？不是 bug，是默认行为

所有常规查询（Find、First、Where）默认自动加 WHERE deleted_at IS NULL。这不是异常，是设计使然。管理后台“回收站”页面直接用 Find() 查不到任何记录，就是因为这个过滤。

• 要查含软删数据：用 db.Unscoped().Where(...).Find(&users)
• 只想临时绕过软删又不想影响其他条件：可手动加 Where("deleted_at IS NULL") 替代 Unscoped()，更可控
• Unscoped() 影响整条链路，后续无法“恢复”软删过滤，慎用于复杂查询
• 统计总数、导出报表等场景容易漏掉 Unscoped()，导致结果少算——尤其当业务方以为“删了就没了”，但 DB 里还堆着几万条 deleted_at != NULL 记录

关联查询（Preload / Joins）不自动过滤软删记录

GORM 不会递归处理关联表的软删逻辑。比如用户软删后，其 Orders 若也启用了软删除，db.Preload("Orders").Find(&user) 仍会把已软删的订单查出来——这不是 bug，是每个模型独立判断的结果。

• 想让预加载也遵守软删规则，必须显式加条件：db.Preload("Orders", func(db *gorm.DB) *gorm.DB { return db.Unscoped().Where("deleted_at IS NULL") })
• HasOne/HasMany 的外键约束不受软删影响：主表软删后，子表记录仍在，只是 DeletedAt 被设值；子表若没定义 DeletedAt，它根本不会被软删
• 硬删前务必确认无活跃关联，尤其日志、审计、统计类表常被忽略；否则 Unscoped().Delete() 可能破坏外键引用，下次插入报 foreign key constraint fails

软删除看着简单，但字段类型、调用链顺序、关联加载、统计口径这四点，任一出错都会导致数据不可见、删不干净、查不准或外键崩坏。生产环境建议禁用裸 Unscoped().Delete()，改用标记位（如 IsPurged bool）+ 定期批处理清理。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。