Go 的 time.Time 默认 JSON 序列化输出 RFC 3339 格式，但业务常需“2024-05-20 14:23:15”等自定义格式；应通过定义新类型（如 LocalTime）并实现 MarshalJSON/UnmarshalJSON 方法解决，不可直接扩展 time.Time。
Go 的 time.Time 默认 JSON 序列化不符合业务需求
Go 标准库对 time.Time 的 JSON 序列化默认输出 RFC 3339 字符串（如 "2024-05-20T14:23:15+08:00"），但多数 API 要求统一为 "2024-05-20 14:23:15" 或纯日期格式。直接用 string 字段绕过序列化会丢失类型安全和时区语义，不推荐。
自定义 MarshalJSON 方法是最可控的方式
给结构体字段所在类型实现 MarshalJSON 和 UnmarshalJSON 是最常用且稳定的做法。注意：必须作用于自定义类型（不能直接在 time.Time 上定义），否则编译报错。
常见错误现象：cannot define new methods on non-local type time.Time
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义新类型如
type LocalTime time.Time，而非type LocalTime struct { t time.Time }（后者需额外处理零值和指针） - 在
MarshalJSON中调用Format，推荐使用time.Local或显式指定时区，避免依赖运行环境时区 -
UnmarshalJSON必须能解析你序列化的格式，否则反序列化失败；建议用time.ParseInLocation并固定时区
示例：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
type LocalTime time.Time
func (t LocalTime) MarshalJSON() ([]byte, error) {
return []byte(fmt.Sprintf(`"%s"`, time.Time(t).In(time.Local).Format("2006-01-02 15:04:05"))), nil
}
func (t *LocalTime) UnmarshalJSON(data []byte) error {
s := strings.Trim(string(data), `"`)
parsed, err := time.ParseInLocation("2006-01-02 15:04:05", s, time.Local)
if err != nil {
return err
}
*t = LocalTime(parsed)
return nil
}
用 github.com/lib/pq 或 github.com/jackc/pgtype 处理 PostgreSQL 场景
如果时间字段来自数据库（尤其 PostgreSQL），直接用 time.Time 可能因驱动差异导致序列化/反序列化行为不一致。比如 lib/pq 默认将 timestamp without time zone 解析为 UTC 时间，但业务期望本地时间展示。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 避免在模型中直接嵌入
time.Time，改用自定义类型（如上）并确保Scan/Value方法与 JSON 行为一致 - 若使用
pgx，可配合pgtype.Timestamptz显式控制时区转换，再转为本地格式输出 - 不要依赖
DB.QueryRow().Scan(&t)自动转换——它不经过UnmarshalJSON，时区逻辑可能脱节
全局替换？小心 json.Marshal 的隐式行为
有人试图通过替换 json.Marshal 函数或注册自定义编码器来“一劳永逸”，但 Go 的 encoding/json 不支持全局 hook。强行用反射或中间层封装，会掩盖类型契约、增加调试难度，且无法兼容第三方库（如 gin 的 c.JSON 内部仍走标准 json.Marshal）。
真正容易被忽略的点：
- 嵌套结构体中多个时间字段，每个都得单独定义类型或用相同命名约定，否则一致性难保障
- 测试时容易漏掉
UnmarshalJSON的边界情况（如空字符串、非法格式），建议用json.RawMessage做模糊校验 - 生成 OpenAPI 文档（如 swag）时，自定义类型默认显示为
string，需手动加// @SchemaExample "2024-05-20 14:23:15"注释
