time.time字段绑定失败时默认设为零值而非报错，是gin的默认行为；需通过自定义datetime类型实现可控解析，并显式处理空值、null及多格式时间字符串，避免静默失败。
time.Time字段绑定失败时默认返回零值，而不是报错
这是 Gin 默认行为：当请求中时间字段格式错误（比如传了 "2023-13-01" 或空字符串），c.ShouldBindJSON() 不会 panic，也不会返回 error，而是把对应 time.Time 字段设为零值 0001-01-01 00:00:00 +0000 UTC。前端看到这个时间，基本等于数据丢失，但后端日志里还看不出异常。
- 必须显式检查零值，不能依赖
err != nil判断绑定是否成功 - 零值本身合法，所以不能只用
t.IsZero()—— 用户真传了 1970 年前的数据也会被误判 - 推荐在结构体字段上加
json:",omitempty"，并配合自定义校验逻辑
用自定义类型替代 time.Time 实现可控制的解析逻辑
直接在 struct 中用 time.Time 无法干预解析过程。更可靠的做法是定义一个包装类型，实现 UnmarshalJSON 方法：
type DateTime struct {
time.Time
}
func (dt *DateTime) UnmarshalJSON(data []byte) error {
s := strings.Trim(string(data), `"`)
if s == "" || s == "null" {
dt.Time = time.Time{}
return nil
}
for _, layout := range []string{
time.RFC3339,
"2006-01-02T15:04:05",
"2006-01-02 15:04:05",
"2006-01-02",
} {
if t, err := time.Parse(layout, s); err == nil {
dt.Time = t
return nil
}
}
return fmt.Errorf("cannot parse %q as time", s)
}
- 多个
layout顺序很重要：RFC3339 放最前，避免被更短格式误匹配 - 必须处理
"null"和空字符串，否则 JSON 解析会失败 - 返回具体错误信息，便于定位是哪个字段、哪种格式出问题
Gin 的 ShouldBindJSON 对嵌套结构体中 time 字段不递归校验
如果结构体里嵌套了另一个 struct，而那个 struct 里有 time.Time 字段，ShouldBindJSON 依然会静默设为零值，且不会触发外层结构体的校验标签（如 binding:"required"）。
-
binding:"required"对time.Time无效 —— 零值不是空值，校验永远通过 - 必须手动遍历嵌套字段，调用
.IsZero()并结合业务含义判断是否合理 - 更稳妥的方式是把嵌套结构也改成自定义类型（如
CreatedAt DateTime），统一控制解析入口
时区处理容易被忽略，导致前后端时间不一致
前端传 "2023-05-20T10:00:00Z" 和 "2023-05-20T10:00:00+08:00"，Go 解析后都是 time.Time，但内部纳秒值不同。如果没注意，存库、比较、格式化都可能出错。
- 入库前建议统一转为 UTC：
t.In(time.UTC)，避免数据库时区配置影响 - 返回给前端时再按需转本地时区，或统一用 RFC3339（含时区）
- 不要依赖
time.Local—— 容器环境里它可能不是你预期的时区
真正麻烦的不是解析失败，而是解析“成功”却用了错误时区或错误精度。这类问题上线后很难复现，只能靠提前约定和统一转换点来规避。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
