Golang软删除实现技巧：利用DeletedAt字段标记删除

GORM 中的软删除并非简单添加 DeletedAt 字段即可生效，而需严格满足结构体字段定义（*time.Time 类型 + gorm:"index" 标签）与全局配置（确保 SoftDelete 插件启用）双重条件；否则 Delete() 仍会执行危险的物理删除，且查询时自动过滤已软删记录、仅 Unscoped() 可安全绕过——但 Unscoped().Delete() 本身却是不可逆的真删除，极易引发数据丢失。本文直击开发者高频踩坑点：从字段类型选择、索引必要性、钩子绕过风险，到关联查询陷阱和定时清理最佳实践，帮你避开“以为软删实则硬删”“查不到数据却找不到原因”等致命误区，真正用对 GORM 软删除。

软删除必须开启 GORM 的 gorm.DeletedAt 字段支持

默认情况下，GORM 不会把 DeletedAt 当作软删除字段——哪怕你加了这个字段，Delete() 仍会执行物理删除。关键在结构体标签和全局配置。

必须同时满足两个条件：

• 结构体中定义 DeletedAt 字段，类型为 *time.Time 或 time.Time，并加上 gorm:"index"（否则查询时可能漏掉软删数据）
• 初始化 DB 时启用软删除：用 GORM 的 SetupJoinTable 不起作用，得靠 gorm.Config{NowFunc: ...} 或更直接的——确保没禁用 SoftDelete 插件（v2 默认已启用，但若手动关过就得重开）

常见错误现象：Delete() 后查不到记录，日志里却是 DELETE FROM xxx ——说明软删除根本没生效，大概率是字段没加 gorm 标签，或用了 Unscoped().Delete() 却误以为是默认行为。

查询时自动过滤已软删记录，但 Unscoped() 是唯一绕过方式

GORM v2 默认所有 Find、First、Where 等方法都会自动加 WHERE deleted_at IS NULL 条件。这不是魔法，是底层 SQL 构建时硬编码的逻辑。

所以别指望靠 Where("deleted_at IS NULL") 来“显式”过滤——它会被合并进已有条件，反而可能出错；也不要用 Where("1=1") 试图清空条件，没用。

• 要查包括已软删的全部数据，必须显式调用 Unscoped()，且它得放在链式调用最前面：db.Unscoped().Where(...).Find(&users)
• Unscoped() 仅对当前语句生效，不会污染后续操作
• 注意：关联查询（如 Preload）默认也受软删除影响，如果主表没软删但关联表有，且你又没 Unscoped() 关联表，就可能 preload 不到数据

DeletedAt 字段值为 nil 表示未删除，非 nil 才算软删

这是 GORM 软删除的判定依据，不是靠布尔字段，也不是靠时间大小比较。所以别手动生成 DeletedAt: time.Now() 去“模拟删除”——该用 Delete() 就用，它会自动赋值。

• 手动赋值 DeletedAt（比如 user.DeletedAt = &now）再 Save()，效果等同于 Delete()，但绕过了 GORM 的软删除钩子（如 BeforeDelete）
• 想恢复软删记录？只需把 DeletedAt 设为 nil 再 Save()，不要用 UpdateColumn()，否则可能跳过钩子或校验
• 字段类型用 *time.Time 更安全：避免零值时间（0001-01-01）被误判为已删除

性能影响很小，但要注意：带 DeletedAt 的表，所有 SELECT 都多一个 WHERE 条件；如果高频查“已删除”数据，记得给 deleted_at 加数据库索引（gorm:"index" 会帮你建，但得确认建成功）。

慎用 Unscoped().Delete()：它真删，且不可逆

这是最容易踩的坑——名字里带 Unscoped，动作却是物理删除。很多人以为只是“不走软删逻辑”，结果执行完发现记录彻底没了。

• db.Unscoped().Delete(&user) → 发出 DELETE FROM users WHERE id = ?，跳过所有软删机制
• 想批量物理删除？可以，但务必确认业务允许，且最好加额外条件（如 Where("deleted_at < ?", time.Now().AddDate(0, 0, -30))）避免误删
• 没有“软删回滚”机制。GORM 不存删除前快照，Unscoped().Delete() 后只能靠数据库备份恢复

真正需要物理清理的场景极少，多数时候应该用定时任务定期 Unscoped().Where(...).Delete(&Model{}) 清理 N 个月前的软删数据，而不是在业务逻辑里混用。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~