Gin默认返回UTC时间是因为依赖Go标准库json.Marshal，而time.Time.MarshalJSON固定输出UTC时间戳；解决方法包括自定义LocalTime类型实现MarshalJSON、预处理转时区、改用string字段或全局替换json.Marshal。
为什么Gin默认返回的time.Time字段总是UTC？
Gin本身不处理time.Time序列化逻辑，它依赖Go标准库的json.Marshal。而time.Time的默认JSON编码会调用Time.MarshalJSON()，该方法**固定输出UTC时间戳（带Z后缀）**，不管原始值是哪个时区——哪怕你用time.Now().In(loc)构造了带本地时区的time，序列化时仍被转成UTC。
如何让Gin返回指定时区的时间字符串？
核心思路：不让time.Time走默认JSON路径，而是用自定义类型封装+实现MarshalJSON方法。常见做法是定义一个带时区信息的包装类型：
type LocalTime struct {
time.Time
Loc *time.Location
}
func (t LocalTime) MarshalJSON() ([]byte, error) {
if t.Time.IsZero() {
return []byte(`null`), nil
}
return []byte(`"` + t.Time.In(t.Loc).Format("2006-01-02T15:04:05+08:00") + `"`), nil
}
使用时替换结构体字段类型：
type Response struct {
CreatedAt LocalTime `json:"created_at"`
}
// 构造时传入目标时区
resp := Response{
CreatedAt: LocalTime{
Time: time.Now(),
Loc: time.Local, // 或 time.LoadLocation("Asia/Shanghai")
},
}
全局统一控制时区输出（避免每个字段手动包装）
如果项目中大量返回time.Time且需统一时区，推荐在JSON序列化前做预处理——**重写Gin的Context.JSON方法**，或更稳妥地：用中间件+自定义响应结构体封装：
立即学习“go语言免费学习笔记（深入）”；
- 定义统一响应结构体，所有
time.Time字段在赋值前先转目标时区：t.In(shanghaiLoc) - 避免直接暴露
time.Time字段，改用string字段存储格式化后的时间（如"2024-03-15T14:23:00+08:00"），彻底绕过JSON序列化时区问题 - 若必须保留
time.Time类型，可全局替换json.Marshal为自定义函数（需谨慎，影响所有JSON操作）
注意time.LoadLocation("Asia/Shanghai")可能失败
time.LoadLocation依赖系统时区数据库，Linux/macOS通常没问题，但Docker Alpine镜像默认不含完整tzdata，会导致LoadLocation返回nil和错误。解决方式：
- Dockerfile中加：
RUN apk add --no-cache tzdata - 或改用固定偏移量构造时区：
time.FixedZone("CST", 8*60*60)（注意：不处理夏令时） - 上线前务必验证：
loc, err := time.LoadLocation("Asia/Shanghai"); if err != nil { log.Fatal(err) }
时区不是配置项，是运行时依赖；没加载成功却静默使用time.UTC，最容易被忽略也最难排查。
