go应用时区问题根源在于运行时、数据库、驱动三者未对齐，解决需统一锚点为utc：启动时设time.local=time.utc，mysql连接加parsetime=true&loc=utc，postgresql用timezone=utc，时间戳存取均按utc处理。
Go 应用启动时没设置 time.Local，数据库写入时间偏移 8 小时
Go 默认使用本地时区，但容器或 Linux 服务器常为 UTC，而开发机是 CST/UTC+8，time.Now() 返回的时间在不同环境语义不一致。数据库（如 MySQL）若配置为 timezone=SYSTEM，又依赖系统时区，就会出现「代码里打印是 10:00，查库变成 02:00」的现象。
根本不是 ORM 的锅，而是 Go 运行时、数据库服务、连接驱动三者时区没对齐。解决路径必须统一锚点：全部切到 UTC，或全部切到业务指定时区（推荐前者）。
- 启动时强制设置全局时区：
time.LoadLocation("UTC")不够，得用time.Local = time.UTC（注意：仅限单例应用，且需在所有 goroutine 启动前执行） - MySQL 连接字符串中显式加
parseTime=true&loc=UTC，否则database/sql驱动默认按本地时区解析TIMESTAMP - PostgreSQL 用户请改用
timezone=utc在 DSN 中，例如：postgres://user:pass@host/db?timezone=utc
使用 gorm.Model 或 sqlx.StructScan 读取时间字段时类型错乱
即使数据库存的是 UTC 时间，如果 Go struct 字段类型是 time.Time，但驱动没正确解析时区，返回的 time.Time 值可能被错误套上本地时区标签（比如显示 2024-05-20 10:00:00 +0800 CST，实际应为 +0000 UTC），后续格式化或比较会出错。
关键不是“怎么转”，而是“别让它错”。检查你的扫描逻辑是否绕过了驱动的时区处理：
- GORM v2 默认启用
parseTime=true，但若手动构造gorm.Config，务必确认NowFunc和FullSaveAssociations不干扰时间字段 - 用
sqlx时，避免用db.Get(&v, "SELECT created_at FROM ...")直接扫进time.Time；改用sql.NullTime或自定义扫描器，显式调用t.In(time.UTC) - 所有对外输出（API JSON、日志）统一用
t.UTC().Format(...)，不要依赖t.String()或默认 JSON marshal
time.UnixMilli() 和数据库 BIGINT 时间戳字段对不上
有些团队为规避时区问题，直接存毫秒时间戳到 BIGINT 字段。但 time.UnixMilli() 返回的是 UTC 时间戳，而如果前端传的是本地时间戳（比如 JS Date.now()），没做时区归一就入库，查询时再用 time.UnixMilli(ts) 构造，结果仍是本地时间对应的 time.Time，只是值对了，语义仍错。
真正安全的做法是：前后端约定所有时间戳都为 UTC 毫秒数，且服务端不做任何“补偿”：
- 接收前端时间戳后，直接存为
int64，不调用time.UnixMilli解析 - 需要转成
time.Time时，只用time.UnixMilli(ts).UTC()—— 虽然UnixMilli本就返回 UTC 时间，但显式.UTC()可防止未来有人误改时区 - 数据库查询返回的
int64，也一律走相同路径还原，避免混用time.Unix()（秒级）和UnixMilli()
Docker 镜像里 /etc/localtime 被挂载导致 Go 读到错误系统时区
很多基础镜像（如 golang:alpine）默认无时区数据，time.LoadLocation("") 会 fallback 到 UTC；但若运维在部署时挂载了宿主机的 /etc/localtime，Go 就可能读到 CST，进而让 time.Local 变成非 UTC，整个链路崩塌。
这不是代码 bug，是部署契约没写清。最稳的防御方式是在入口文件里「双重锁定」：
- 启动时第一行就执行：
time.Local = time.UTC（注意：此操作不可逆，且仅对当前进程有效） - Dockerfile 中显式安装时区数据并设为 UTC：
RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/UTC /etc/localtime - CI/CD 流水线中加检查脚本：
docker run --rm your-image sh -c 'go run -e "package main;import(\"time\");func main(){print(time.Now().Location())}"'，确保输出是UTC
时区问题从来不是单点修复，它藏在 Go 运行时、SQL 驱动、数据库配置、容器环境、甚至前端 Date 对象里。少一个环节对齐，就可能在某个凌晨三点的数据报表里突然冒出来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
