GORM软删除需显式声明DeletedAt字段或嵌入gorm.Model,否则Delete()将物理删除;未传主键时Delete()会全表删除;Unscoped()须前置且级联需手动处理;查询软删除数据必须用Unscoped()。

软删除字段没加 gorm.Model 或自定义字段导致物理删除
GORM 默认启用软删除(Soft Delete),前提是结构体嵌入了 gorm.Model(含 DeletedAt 字段)或显式声明了 gorm.DeletedAt。如果结构体只定义了普通字段,比如 CreatedAt、UpdatedAt,但漏掉 DeletedAt time.Time 且没加 gorm.DeletedAt 标签,调用 Delete() 就会直接执行 SQL DELETE FROM —— 数据彻底消失。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 确认结构体是否嵌入
gorm.Model;若不想用完整模型,至少加上DeletedAt *time.Time `gorm:"index"` - 检查迁移或自动建表结果:运行
db.Migrator().CreateTable(&YourModel{})后,用DESCRIBE your_table验证是否存在deleted_at列 - 避免手动写
db.Unscoped().Delete(...)作为默认逻辑——它绕过软删除,容易误删
Delete() 不传主键时触发全表删除风险
GORM 的 Delete() 方法在未指定 WHERE 条件时,会作用于整个模型对应的数据表。例如 db.Delete(&User{}) 在没有 WHERE 子句的情况下,可能清空所有用户记录(尤其在未开启事务或未加 Where() 的情况下)。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 永远显式传入主键值:
db.Delete(&User{}, 123)或db.Where("id = ?", 123).Delete(&User{}) - 对批量操作加限制:
db.Where("status = ?", "inactive").Limit(100).Delete(&User{}),防止误删大量数据 - 开发/测试环境可启用 GORM 日志:
db = db.Debug(),观察生成的 SQL 是否带预期 WHERE 条件
硬删除必须显式调用 Unscoped() 且注意级联行为
要真正从数据库移除记录(包括关联数据),不能只靠 Unscoped().Delete()。GORM 的级联删除(如 foreignKey:UserID;constraint:OnDelete:CASCADE)默认只在软删除上下文中生效;一旦调用 Unscoped(),外键约束和级联规则会被跳过,关联表数据不会自动清理。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 硬删除前先手动清理依赖:
db.Unscoped().Where("user_id = ?", userID).Delete(&Order{}),再删主表 - 若依赖数据库级联,确保建表时外键已设
ON DELETE CASCADE,且 GORM 没有覆盖该行为(即没在 struct tag 中禁用 constraint) -
Unscoped()是链式方法,必须放在Delete()前:错误写法db.Delete(&u).Unscoped()无效
查询软删除数据时忘记 Unscoped() 导致“数据丢失”错觉
软删除后,常规 First()、Find()、Count() 都自动过滤掉 DeletedAt IS NOT NULL 的记录。开发者常以为数据丢了,其实是 GORM 默认屏蔽了它们。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 查回收站或审计日志时,必须加
Unscoped():db.Unscoped().Where("deleted_at IS NOT NULL").Find(&users) - 统计总数时注意区分:
db.Count(&total)返回有效数,db.Unscoped().Count(&total)才是全量 - 避免在业务逻辑中混用
Unscoped()和非Unscoped()查询,容易引发状态不一致;建议封装统一的 Repository 方法隔离软/硬语义
DeletedAt 字段,或一次漏掉的 Unscoped(),都可能让数据在“可见”和“不可见”之间无声切换。

















