You need to enable JavaScript to run this app. GORM执行更新查询时自动在WHERE条件追加DeletedAt列原因排查
优惠活动
大模型
产品
解决方案
定价
更多

GORM执行更新查询时自动在WHERE条件追加DeletedAt列原因排查

问题根因

这是GORM框架内置软删除机制触发的自动行为,属于框架默认设计逻辑而非运行Bug:

  • GORM会自动识别结构体中的软删除字段,只要字段命名为DeletedAt、类型为可空时间类型(比如你定义的*time.Time),哪怕你没有显式使用框架内置的gorm.DeletedAt类型,框架也会自动给所有常规的查询、更新、删除操作注入DeletedAt IS NULL的过滤条件,避免操作到已经被标记为软删除的历史记录。
  • 你在调试输出里看到的DelatedAt是拼写笔误(漏写了字母e),实际框架生成的SQL列名和你gorm标签定义的DeletedAt完全一致,和你全大写的表名、列名命名规则没有关联。
可选择的解决方案

根据你的业务需求匹配对应处理方式:

  • 不需要软删除能力:直接把结构体中定义的DeletedAt *time.Time字段移除,框架将不再自动注入对应的过滤条件。
  • 需要保留软删除能力,但本次操作需要匹配所有记录(包括已被软删除的记录):在查询链中添加Unscoped()方法,该方法是GORM专门提供的软删除规则绕过入口,添加后即可完全跳过自动注入的软删除过滤条件,示例代码如下:
if err := database.GetMysqlDB().Debug().
    Model(&User{}).
    Unscoped(). // 绕过软删除自动过滤规则
    Where("ID = ?", 15).
    UpdateColumns(user).Error; err != nil {
    fmt.Println(err)
}
  • 需要保留DeletedAt字段存储删除时间值,但完全不希望触发软删除的自动过滤:将结构体字段名从DeletedAt改成其他名称(比如DeleteTime),即可避开GORM的软删除字段识别规则,同时按照自定义的gorm标签映射原有大写列名即可。

内容的提问来源于stack exchange,提问作者Fazlan Ahamed

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 08:06:03