Beego ORM 中软删除需手动建模为 *time.Time 类型的 DeletedAt 字段并加 orm:"null" 标签,查询未删除数据必须用 Filter("deleted_at__isnull", true),更新时须显式指定字段避免覆盖 DeletedAt,所有读操作均需手动添加该过滤条件以防数据泄露。

Beego ORM 中软删除字段怎么建模
软删除通常用 is_deleted(bool)或 deleted_at(datetime)字段实现。Beego ORM 不内置软删除支持,必须手动建模并参与查询逻辑。
推荐用 deleted_at *time.Time 字段,语义更清晰、便于后续扩展(比如恢复、审计)。建模时注意:
-
deleted_at字段需加orm:"null"tag,否则插入时会因零值触发非空约束报错 - 不要用
is_deleted bool+ 默认false,因为Filter("is_deleted", false)会查出所有显式为false的记录,但漏掉NULL(即未删)的记录——这两者在 SQL 里完全不等价 - 示例建模:
type User struct { Id int `orm:"pk;auto"` Name string `orm:"size(30)"` DeletedAt *time.Time `orm:"null;column(deleted_at)"` }QueryTable.Filter() 筛选未删除数据的写法
要查“未删除”的数据,本质是查
deleted_at IS NULL,对应 Beego ORM 的表达式是deleted_at__isnull,且值必须传true。错误写法:
qs.Filter("deleted_at", nil)或qs.Filter("deleted_at", "")—— 这些都会被转成= NULL或= '',SQL 语法错误或逻辑错乱。正确写法只有这一种:
qs := o.QueryTable(&User{}).Filter("deleted_at__isnull", true)如果还要叠加其他条件(如按城市查),必须链式调用:
qs.Filter("deleted_at__isnull", true).Filter("city", "shenzhen")注意:不能分开两行写,否则第二行的
Filter()作用在原始qs上,前一个条件丢失。软删除状态下如何安全地做更新和删除
软删除不是真删,所以
Delete()要重写逻辑;更新时也得避免误清deleted_at。更新操作建议统一走
Update()并显式指定字段,防止把deleted_at覆盖为零值:user := User{Id: 123} if err := o.Read(&user); err != nil { /* handle */ } user.Name = "new name" _, _ = o.Update(&user, "name") // 只更新 name,deleted_at 不变软删除操作应改用
Update()设置deleted_at:now := time.Now() _, _ = o.Update(&User{Id: 123, DeletedAt: &now}, "deleted_at")硬删除(物理删除)极少需要,若真要执行,必须显式绕过软删除逻辑:
o.Raw("DELETE FROM user WHERE id = ?", 123).Exec()Raw() 查询中处理软删除的注意事项
当用
Raw()写复杂查询(比如 JOIN + GROUP BY)时,deleted_at__isnull表达式不可用,必须手写 SQL 条件。常见错误是拼接字符串:
Raw("SELECT * FROM user WHERE deleted_at IS NULL AND name LIKE '%" + kw + "%'") ❌正确方式是用参数占位符,并确保
IS NULL是固定 SQL 片段:o.Raw("SELECT * FROM user WHERE deleted_at IS NULL AND name LIKE ?", "%"+kw+"%").QueryRows(&users)如果查询结果要反查关联数据(比如用户订单),别忘了在每个 JOIN 表里都加软删除判断,否则会拉出已删除用户的脏数据。
软删除最易忽略的点是:所有读操作默认都该加
deleted_at__isnull,但 Beego ORM 不会自动注入——你得在每一处QueryTable()后手动补上,漏一处就可能泄露已删除数据。











