time.ParseInLocation 是 Gin 解析表单日期的正确入口，需显式指定时区（如 time.Local 或 LoadLocation），配合自定义类型实现 UnmarshalText 支持多格式，并注意 GORM 零值覆盖问题。
time.ParseInLocation 是 Gin 解析表单日期的正确入口
Gin 默认不自动处理带时区或中文语义的日期字符串，比如 "2025-08-12" 或 "2025-08-12 14:30:00"，直接用 c.ShouldBind() 绑定到 time.Time 字段会 panic 或返回零值。根本原因是 Go 的 time.Parse 要求格式严格匹配，且默认使用 time.UTC，而表单提交通常来自本地时区。
必须显式调用 time.ParseInLocation，并传入 time.Local（或明确加载的时区，如 time.LoadLocation("Asia/Shanghai")）：
dateStr := c.DefaultPostForm("deadline", "")
t, err := time.ParseInLocation("2006-01-02", dateStr, time.Local)
if err != nil {
c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "invalid date format"})
return
}
- 不要用
time.Parse，它忽略时区上下文，容易导致时间偏移 8 小时 - 格式字符串必须与输入完全一致：前端传
"2025/08/12"，你就得写"2006/01/02"，不能混用 -
time.Local在多数 Linux/macOS 环境下能正确映射系统时区；但容器中可能失效，建议生产环境显式指定time.LoadLocation("Asia/Shanghai")
Gin binding struct 中 time.Time 字段需自定义类型
直接在结构体里声明 CreatedAt time.Time `form:"created_at"` 无法支持任意格式，Gin 的默认绑定只认 RFC3339（"2006-01-02T15:04:05Z"）或空字符串转零值。要兼容表单常用格式（如 "2025-08-12"、"2025-08-12 14:30"），必须封装自定义类型并实现 UnmarshalText 方法：
type Date struct{ time.Time }
func (d *Date) UnmarshalText(text []byte) error {
s := string(text)
if s == "" {
d.Time = time.Time{}
return nil
}
t, err := time.ParseInLocation("2006-01-02", s, time.Local)
if err != nil {
t, err = time.ParseInLocation("2006-01-02 15:04", s, time.Local)
}
if err != nil {
t, err = time.ParseInLocation("2006-01-02 15:04:05", s, time.Local)
}
if err != nil {
return fmt.Errorf("cannot parse %q as date", s)
}
d.Time = t
return nil
}
- 结构体字段改用
Deadline Date `form:"deadline"`，就能自动解析多种常见格式 - 注意顺序：先试最短格式（年月日），再逐步加时分秒，避免
"2025-08-12"被误判为含时分的格式而失败 - 不要实现
UnmarshalJSON—— 表单是application/x-www-form-urlencoded，走的是UnmarshalText分支
前端传参格式不统一时，服务端别硬扛
当多个前端（Vue、React、小程序）各自拼接日期字符串，出现 "2025-08-12"、"2025/08/12"、"2025年08月12日" 混用，服务端强行在 UnmarshalText 里堆 if-else 判断格式，会迅速失控。
立即学习“go语言免费学习笔记（深入）”；
更可靠的做法是前端约定统一格式，并在提交前标准化：
- 强制所有 JS 端用
date.toISOString().split('T')[0]生成"2025-08-12" - 或后端只接受时间戳（
deadline=1755014400），用c.GetInt64("deadline")+time.Unix()转换，彻底规避字符串解析 - 若必须支持中文，可加一层中间件预处理：扫描所有 form key，对已知日期字段名（如
start_time,end_date）尝试用dateparse.ParseAny()（第三方库）统一转成标准格式再放回 context
GORM 更新时 time.Time 字段被重置为零值
用 Gin 绑定结构体后直传 GORM db.Save()，发现 UpdatedAt 变成 "0001-01-01"，不是解析失败，而是 GORM 的零值覆盖逻辑在作祟。
关键点在于：time.Time{} 是零值，GORM 认为“用户没设值”，就用数据库默认值（或清空）。
- 绑定结构体时，把
UpdatedAt改成指针：UpdatedAt *time.Time `gorm:"column:updated_at"`，零值就是nil，GORM 不会覆盖 - 或改用
db.Omit("updated_at").Save(&obj)显式跳过 - 更推荐：GORM v2 开启
Config.NowFunc自动注入更新时间，而非依赖表单传入
日期格式问题从来不是单点故障，它横跨前端序列化、HTTP 传输、Gin 绑定、GORM 持久化四层。最容易被忽略的是时区隐式转换和零值语义——这两处一错，时间就差出半天。
