GORM能否通过传入map条件实现数值或时间类型的范围查询

• GORM 原生支持接收map类型作为Where方法的入参，但默认只会把map中的键值对解析为「字段 = 值」的等值匹配条件，直接传普通map没法生成BETWEEN范围查询的SQL。

  要是你给字段传切片类型的值，比如map[string]interface{}{"mileage": []int{100,200}}，GORM会把它解析成mileage IN (100,200)的IN查询，不是你要的BETWEEN效果。

实现范围查询的两种常用方式 #

1. 直接写Where条件表达式（最推荐） #

这是最不容易出错、可读性最高的写法，数值、时间类字段的范围逻辑都能直接实现：

// 数值范围查询 对应SQL: WHERE mileage BETWEEN 100 AND 200
db.Where("mileage BETWEEN ? AND ?", 100, 200).Find(&cars)

// 时间范围查询 对应SQL: WHERE created_at BETWEEN '2024-01-01' AND '2024-06-01'
db.Where("created_at BETWEEN ? AND ?", time.Date(2024,1,1,0,0,0,0,time.Local), time.Date(2024,6,1,0,0,0,0,time.Local)).Find(&cars)

2. 结合gorm.Expr在map中封装范围条件 #

如果你需要把所有筛选条件统一封装成map结构，可以把范围条件的值设为gorm.Expr类型，GORM识别到这个类型就不会做默认的等值转换，会直接按你写的表达式拼接SQL：

queryCond := map[string]interface{}{
    // 范围条件用Expr包裹
    "mileage":    gorm.Expr("BETWEEN ? AND ?", 100, 200),
    "created_at": gorm.Expr("BETWEEN ? AND ?", startTime, endTime),
    // 普通等值条件正常传值即可，会自动解析为 status = 1
    "status":     1,
}
// 最终生成SQL: WHERE mileage BETWEEN 100 AND 200 AND created_at BETWEEN ? AND ? AND status = 1
db.Where(queryCond).Find(&cars)

踩坑提醒 #

• 时间字段查询尽量直接传time.Time类型值，别手动拼格式化后的字符串，容易出现时区不匹配、类型转换错误，还会有SQL注入风险。
• 大于、小于这类比较范围（比如mileage > 100）也可以用同样的gorm.Expr方式写进map里。

内容的提问来源于stack exchange，提问作者Stuart