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
相关产品推荐
相关产品推荐

