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

老客户端传的时间戳格式(如秒级 1733725200)和新接口要求的毫秒级 1733725200123 不兼容?别改客户端,直接在服务端做无感适配。
怎么识别老时间戳并自动补零
Go 的 time.Unix() 和 time.UnixMilli() 对输入长度敏感,但没内置判断逻辑。不能靠 try-catch 或 errors.Is(err, time.ErrInvalid) 来兜底——性能差、语义模糊。正确做法是提前按位数分流:
- 传入数字 ≤ 10 位(即
)→ 当作秒级时间戳,调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 方法封装转换逻辑:
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 <p>这样所有用 <code>Timestamp</code> 类型的字段都会自动适配,业务 handler 完全无感知。别给 <code>time.Time</code> 加方法——它不是你定义的类型,Go 不允许。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill8661" title="Golang Uber Dig"><img
src="https://img.php.cn/upload/skill/000/000/081/179215391842073.jpg" alt="Golang Uber Dig" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill8661" title="Golang Uber Dig" class="overflowclass">Golang Uber Dig</a>
<p class="overflowclass">使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等</p>
</div>
<a rel="nofollow" href="/xiazai/skill8661" title="Golang Uber Dig" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h3>为什么不能用中间件全局转时间戳</h3><p>中间件层无法安全地重写原始 JSON body。原因有三:</p>
- 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 年。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










