当前位置：首页 > 文章列表 > Golang > Go问答 > Go 时间做 JSON 往返后为什么丢失单调时钟信息

Go 时间做 JSON 往返后为什么丢失单调时钟信息

来源：17golang原创 2026-10-06 03:36:03 0浏览收藏

Go 时间做 JSON 往返后，丢失的是 time.Time 里只对当前进程有意义的单调时钟读数，不是日期、时分秒或时区偏移。time.Now() 得到的值可以同时参与墙上时间展示和本地耗时计算；MarshalJSON 只输出可跨进程解释的时间表示，UnmarshalJSON 重新得到的值自然没有原来的 monotonic 部分。

要点速览

墙上时间用于记录发生时间，单调时钟用于同一进程内测量间隔。
JSON 往返保留日历时刻，不会传输或恢复单调读数。
接口和数据库保存 RFC3339 或 Unix 时间；耗时跨边界时显式保存 time.Duration 数值。

Go 的 time.Time 为什么看起来同时有两种时间

time.Now() 返回的 Time 可能含有墙上时间和单调时钟。前者会受系统校时影响，适合日志、订单发生时间和过期时间展示；后者只在当前进程的时间线上有意义，适合 Sub、Since、Until 等耗时运算。打印 Time.String() 时看到的 m=+... 是调试痕迹，不是可以写入接口的字段。

Go time.Time 墙上时间和单调读数穿过 JSON 边界的结构说明图 — 图1：静态说明图，展示 time.Time 的双时钟语义与 JSON 边界。

数据语义	推荐用途	跨 JSON 后的结果
墙上时间	事件时间、日志、业务字段	保留为 RFC3339 等日历表示
单调读数	同一进程内测量间隔	按设计丢弃，不能跨进程解释
Duration	已经算出的耗时	可显式传整数纳秒或字符串

JSON 往返保留了什么，又为什么不会保留 monotonic

time.Time 的 JSON 方法使用 RFC3339 语义表达时间点。这个字符串可以被另一台机器、另一个进程或不同语言解析，但单调读数依赖创建它的进程时钟基准，离开该进程后没有可比对象。因此 Go 官方文档明确规定，MarshalJSON、MarshalText 等序列化形式省略单调读数，UnmarshalJSON 得到的时间也不含它。

package main

import (
    "encoding/json"
    "fmt"
    "time"
)

func main() {
    original := time.Now()
    data, err := json.Marshal(original)
    if err != nil {
        panic(err) // 序列化失败时停止，避免把不完整时间写入接口。
    }

    var roundTrip time.Time
    if err := json.Unmarshal(data, &roundTrip); err != nil {
        panic(err) // 解析失败时不能继续比较时间结果。
    }

    fmt.Println(string(data))
    fmt.Println(original.Equal(roundTrip)) // 比较时间点，不要求内部单调状态相同。
}

这里即使两个值代表同一时间点，也不要用 original == roundTrip 推断 JSON 失败。== 还会比较位置和单调读数；业务上的时间点判断应优先使用 Equal，而且应先明确是否需要保留原始时区名称。

持久化时间和本地耗时要分开设计

事件发生时间应按协议需要保存为 RFC3339、Unix 秒或 Unix 纳秒，并明确精度和时区。性能统计、超时计算则应在同一进程里从开始时刻到结束时刻直接调用 Sub；如果结果要发给另一个服务，发送已经算出的 Duration 数值，而不是试图把单调读数塞回 JSON。

Go 事件时间与本地耗时跨 API 和数据库的分层设计说明图 — 图2：静态说明图，展示持久化事件时间与本地耗时的分层方案。

type EventDTO struct {
    OccurredAt time.Time `json:"occurred_at"`
    ElapsedNS  int64     `json:"elapsed_ns,omitempty"`
}

func measure() EventDTO {
    started := time.Now()
    // 这里代表当前进程内的业务操作，耗时只在本地计算。
    doWork()
    elapsed := time.Since(started)
    return EventDTO{
        OccurredAt: time.Now().UTC(),
        ElapsedNS:  elapsed.Nanoseconds(), // 显式传结果，不传内部 monotonic 状态。
    }
}

如果字段代表截止时间而不是发生时间，接收端应使用自己的 time.Now() 与解析后的墙上时间比较，并为网络延迟、时钟偏差设置边界。不要把序列化前后的 Sub 结果当成跨服务精确计时。