在 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 语义转换，开发者需主动写出符合标准的条件表达式，才能确保查询语义准确、结果可靠。
