Gin绑定Time字段报错因默认用time.Parse解析空字符串、"null"等非法值；解决方案包括：①自定义UnmarshalJSON跳过空值，②用*time.Time+binding:"optional"跳过缺失字段，③避免全局修改time.Time绑定器。
为什么Gin绑定Time字段会报time: invalid duration或parsing time错误
因为Gin默认用time.Parse解析时间字符串，而空字符串""、"null"、缺失字段或空白格（如" "）都会触发解析失败。Gin不自动跳过空值，也不区分“未提供”和“提供但为空”，一律尝试解析，结果就是Binding error直接中断请求。
用自定义UnmarshalJSON方法绕过空值校验
给结构体字段定义接收器方法，接管JSON反序列化逻辑——这是最可控的方式。关键点是：遇到空值、零值字符串时，直接设为time.Time{}（即零时间），不调用time.Parse。
示例：
type MyRequest struct {
CreatedAt CustomTime `json:"created_at"`
}
type CustomTime struct {
time.Time
}
func (ct *CustomTime) UnmarshalJSON(data []byte) error {
s := strings.TrimSpace(string(data))
if s == "" || s == "null" || s == `""` {
ct.Time = time.Time{}
return nil
}
// 去掉引号再解析
s = strings.Trim(s, `"`)
t, err := time.Parse("2006-01-02T15:04:05Z", s)
if err != nil {
return err
}
ct.Time = t
return nil
}
- 必须用指针接收器（
*CustomTime），否则无法修改原值 - 注意处理带引号的JSON字符串（
"2023-01-01T00:00:00Z"），strings.Trim(s, `"")不能少 - 如果前端可能传多种格式（如
"2023-01-01"），需在time.Parse里叠加多个time.Parse尝试，或用time.ParseInLocation指定时区
用binding:"optional"配合指针类型更简单
如果字段允许为空，直接声明为*time.Time，并加binding:"optional"标签。Gin 1.9+ 支持该tag，遇到空值、缺失字段时跳过绑定，保持指针为nil。
立即学习“go语言免费学习笔记（深入）”；
示例：
type MyRequest struct {
CreatedAt *time.Time `json:"created_at" binding:"optional"`
}
-
binding:"optional"只对指针/接口/切片等零值有意义的类型生效 - 后续代码需判空：
if req.CreatedAt != nil { ... } - 注意：若前端传
"created_at": ""，仍会触发解析失败——optional只跳过字段缺失，不处理空字符串。所以仍需配合前端约定或中间件清洗
全局注册time.Time的自定义绑定器（慎用）
Gin允许通过gin.RegisterValidator或替换binding引擎来统一处理time.Time，但实际不推荐——它会影响所有time.Time字段，包括你希望严格校验的场景（如创建时间必须非空）。容易掩盖业务意图。
真正需要全局处理时，更稳妥的做法是封装一个SafeTime类型，仅在明确需要宽松解析的地方显式使用，而不是污染基础类型。
空值问题本质是前后端契约不清：后端期望时间，前端却传了空字符串。最省心的解法往往不是改框架，而是加一层轻量中间件，在Bind前把"created_at": ""这类键值对从c.Request.Body中剔除或转为null——但这要求你能控制Body读取时机，且别和Gin的ShouldBind冲突。
