GORM查询NULL时间字段技巧

在 GORM 中查询 NULL 时间字段（如软删除字段 `deleted_at`）时，直接传入 `nil` 会导致生成错误的 `= NULL` SQL 语句——而根据 SQL 标准，该表达式恒为 false，致使查询永远返回空结果；正确做法是显式使用 `"deleted_at IS NULL"` 这类标准 SQL 片段，才能精准匹配数据库中的 NULL 值，避免因语义误解引发的数据遗漏或逻辑漏洞。

在 GORM 中，直接使用 Where("deleted_at", nil) 无法匹配数据库中的 NULL 值，因为 SQL 标准规定 = NULL 恒为 false；必须显式使用 IS NULL 条件才能正确筛选未软删除的记录。

在 GORM 中，直接使用 Where("deleted_at", nil) 无法匹配数据库中的 NULL 值，因为 SQL 标准规定 = NULL 恒为 false；必须显式使用 IS NULL 条件才能正确筛选未软删除的记录。

GORM 默认支持软删除（Soft Delete），通过 DeletedAt 字段（类型为 *time.Time）标记逻辑删除状态。当该字段为 NULL 时，表示记录未被删除；而 nil 在 Go 中虽等价于空指针，但 GORM 不会自动将其翻译为 SQL 的 IS NULL —— 它会生成 = ? 参数化查询，传入 nil 后实际执行类似 deleted_at = NULL 的语句，这在 SQL 中永远返回 false，导致查询结果为空。

✅ 正确做法是显式书写 SQL 片段，确保生成标准的 IS NULL 判断：

var users []models.User
err := db.Where("deleted_at IS NULL").Find(&users).Error
if err != nil {
    log.Fatal("查询用户失败:", err)
}

⚠️ 注意事项：

• 不要使用 db.Where("deleted_at", nil) 或 db.Where("deleted_at = ?", nil)，二者均无效；
• 避免硬编码字段名大小写：GORM 默认使用蛇形命名（如 deleted_at），若模型中自定义了列名（如 gorm:"column:deletedAt"），需同步调整 SQL 字符串；
• 若需组合条件（例如同时过滤未删除 + 某个用户名），可链式调用：

  db.Where("deleted_at IS NULL").Where("username LIKE ?", "%admin%").Find(&users)

• 更简洁的替代方案：启用 GORM 内置软删除行为（默认开启），直接使用 Unscoped() 控制范围——但注意：db.Find(&users) 默认已自动排除 DeletedAt IS NOT NULL 的记录，即常规查询天然只返回“未删除”数据。因此，仅当您此前调用了 Unscoped() 或需显式强调逻辑时，才需手动加 IS NULL 条件。

? 总结：与 NULL 比较必须使用 IS NULL / IS NOT NULL，这是 SQL 语法铁律。GORM 不会对 nil 值做特殊 SQL 语义转换，开发者需主动写出符合标准的条件表达式，才能确保查询语义准确、结果可靠。

好了，本文到此结束，带大家了解了《GORM查询NULL时间字段技巧》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！