Unix 时间戳解释：秒、毫秒、UTC 与日志调试

Unix time 计量从 1970 年开始经过的时间，基准是 UTC。时间戳不是带时区的字符串，而是一个计数。同一个时间戳在各地代表同一瞬间，但显示成不同本地时间。

很多 API 和数据库用秒，JavaScript Date 常用毫秒。混用会让日期偏离一千倍：秒被当毫秒会接近 1970，毫秒被当秒会跑到很远未来。当前秒级时间戳通常 10 位，毫秒级通常 13 位。

调试时本地时间会制造混乱，因为每个人看到的显示可能不同。UTC 给团队共同参考。用户界面可以显示本地时间，但事故记录、日志、token claim、数据库比较和调度分析应包含 UTC 或明确时区。

JWT 的 exp、iat、nbf 通常用秒。日志平台可能同时保存事件时间、写入时间、处理时间和显示时间。Webhook 也可能区分事件发生和系统收到。比较时间时要先知道每个数字代表哪件事。

分布式系统依赖大体同步但不完美的时钟。一个服务器签发的 token 在另一个服务器看来可能稍微来自未来。小容差合理，但不能用巨大容差掩盖秒毫秒混淆或时区错误。

格式化日期可能省略秒、毫秒、时区或偏移。它更好读，但调试能力更弱。如果两个事件看似同一分钟发生，毫秒精度可能仍能说明顺序。无时区日期字符串也可能被另一个系统按本地时间解释。

时间看起来不对时，先判断单位是秒、毫秒、微秒还是纳秒；转成 UTC；再转相关本地时区；确认该时间代表哪个事件；用同一单位和相邻事件比较；最后把预期单位写进 API 文档、数据库注释或类型名。