应提前按数值范围分流:≤10位(

老客户端传的时间戳格式(如秒级 1733725200)和新接口要求的毫秒级 1733725200123 不兼容?别改客户端,直接在服务端做无感适配。
怎么识别老时间戳并自动补零
Go 的 time.Unix() 和 time.UnixMilli() 对输入长度敏感,但没内置判断逻辑。不能靠 try-catch 或 errors.Is(err, time.ErrInvalid) 来兜底——性能差、语义模糊。正确做法是提前按位数分流:
- 传入数字 ≤ 10 位(即
)→ 当作秒级时间戳,调 <code>time.Unix(ts, 0) - 传入数字 13 位 → 当作毫秒级,调
time.UnixMilli(ts) - 其他位数(比如 12 或 14)→ 显式返回
400 Bad Request,带错误字段说明期望格式
注意:别用字符串长度判断,因为 JSON 解析后已经是 int64,len(fmt.Sprint(ts)) 有分配开销;直接数值范围判断更快更稳。
JSON 反序列化时怎么统一处理
如果时间戳字段嵌在请求体里(如 {"created_at": 1733725200}),别在 handler 里手动解析。用自定义 UnmarshalJSON 方法封装转换逻辑:
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
type Timestamp struct {
time.Time
}
func (t *Timestamp) UnmarshalJSON(data []byte) error {
var ts int64
if err := json.Unmarshal(data, &ts); err != nil {
return err
}
switch {
case ts < 1e10:
t.Time = time.Unix(ts, 0)
case ts < 1e13:
t.Time = time.UnixMilli(ts)
default:
return fmt.Errorf("invalid timestamp: %d, expect 10-digit (seconds) or 13-digit (ms)", ts)
}
return nil
}
这样所有用 Timestamp 类型的字段都会自动适配,业务 handler 完全无感知。别给 time.Time 加方法——它不是你定义的类型,Go 不允许。
为什么不能用中间件全局转时间戳
中间件层无法安全地重写原始 JSON body。原因有三:
- body 只能读一次,重读后下游
json.NewDecoder(r.Body)会得到空数据 - 时间戳可能藏在任意嵌套层级(如
{"meta": {"event_time": 1733725200}}),正则或字符串替换极易误伤 - 不同接口对时间字段命名不一致(
created_at/ts/occurred_at),中间件没法通用识别
真正可控的点只有两个:路由 handler 入口、结构体字段反序列化。前者太晚(已进业务逻辑),后者最干净。
数据库写入前要不要归一为 UTC 毫秒
要,但必须在适配之后、入库之前做。关键不是“存什么”,而是“存的时候别引入新歧义”:
- 无论输入是秒还是毫秒,
t.Time.UTC().UnixMilli()得到的是标准 UTC 毫秒值,可安全存入 BIGINT 字段 - 千万别在适配前就调
.UTC()——秒级time.Unix(1733725200, 0)默认是本地时区,.UTC()会多转一次,结果错 8 小时 - 如果 DB 字段是
TIMESTAMP类型,确保连接参数含parseTime=true&loc=UTC,否则驱动可能按本地时区解析
最易被忽略的是:前端 JS 的 Date.now() 是毫秒,但某些旧 SDK 用 Math.floor(Date.now() / 1000) 发秒级,而 Go 后端若没区分就直传给 time.UnixMilli(),会导致时间跳回 1970 年。

















