Go中time.Time默认序列化为RFC 3339格式，需通过自定义类型重写MarshalJSON/UnmarshalJSON实现如"2024-05-12"等定制格式，同时注意时区、空值及UTC统一存储规范。
Go 中 time.Time 默认序列化为什么不是你想要的格式
Go 的 json.Marshal 对 time.Time 默认输出 RFC 3339 格式（如 "2024-05-12T14:23:00Z"），而多数 API 要求的是 "2024-05-12" 或 "2024-05-12 14:23:00" 这类字符串。直接用结构体字段类型为 time.Time 会导致格式不匹配，前端解析失败或后端校验报错。
根本原因在于 Go 标准库没提供全局日期格式配置，必须显式控制每个字段的 JSON 编解码行为。
- 不要试图用
fmt.Sprintf在字段赋值时提前转成字符串——这会让类型丢失、无法参与时间计算 - 避免在每次 Marshal 前手动遍历结构体做字符串替换——破坏类型安全且易漏字段
- 标准库的
time.Time实现了MarshalJSON和UnmarshalJSON方法，但默认逻辑不可覆盖，只能靠自定义类型绕过
用自定义类型实现 MarshalJSON/UnmarshalJSON
最稳妥的做法是定义一个包装 time.Time 的新类型，并重写它的 JSON 方法。这样既保留时间计算能力，又控制序列化形态。
例如支持 "2006-01-02" 格式的日期：
立即学习“go语言免费学习笔记（深入）”；
type Date struct {
time.Time
}
func (d Date) MarshalJSON() ([]byte, error) {
return []byte(`"` + d.Format("2006-01-02") + `"`), nil
}
func (d *Date) UnmarshalJSON(data []byte) error {
s := strings.Trim(string(data), `"`)
t, err := time.Parse("2006-01-02", s)
if err != nil {
return err
}
*d = Date{t}
return nil
}
- 注意
UnmarshalJSON接收指针 receiver，否则无法修改原值 -
MarshalJSON返回的是带双引号的 JSON 字符串字节，不能漏掉`"`包裹 - 如果要支持空值（
null），需在方法中判断len(data) == 0 || string(data) == "null"
使用 json.RawMessage 延迟解析再转换
当结构体嵌套深、日期字段分散、或格式规则动态变化时，先用 json.RawMessage 把原始 JSON 字节缓存下来，等真正需要时再按需解析，能避免早期硬编码格式带来的耦合。
适用于：第三方 API 返回字段名不确定、同一字段可能返回不同格式（如 "2024-05-12" 或 "2024-05-12T00:00:00Z"）。
- 结构体字段声明为
CreatedAt json.RawMessage - 在业务逻辑里调用
json.Unmarshal并尝试多种time.Parse格式，捕获错误后 fallback - 比全量自定义类型更灵活，但增加运行时开销和错误处理分支
别忽略时区和零值问题
很多线上 bug 不是格式不对，而是时区隐式转换或零值误判导致的。比如：
-
time.Time{}默认是 UTC 零时刻（0001-01-01T00:00:00Z），JSON 序列化后变成"0001-01-01T00:00:00Z"，而非null—— 如果业务上该字段可为空，必须用*time.Time或自定义类型内加Valid bool字段 - 前端传来的
"2024-05-12"默认被解析为本地时区午夜，但存储时可能被转成 UTC 导致日期偏移一天 - 建议统一约定：所有日期字段以 UTC 存储，展示层由前端按用户时区转换；若必须用本地时间，解析时显式调用
time.ParseInLocation
日期格式转换看着只是字符串操作，实际牵扯到时区、空值语义、API 协议一致性——这些细节一旦漏掉，调试成本远高于初期多写几行封装代码。
