Golang 小技巧：使用 UseNumber 避免 JSON 大整数精度丢失

在 Go 中，如果使用 map[string]any 接收 JSON 数据，数字默认会被解析成 float64。

例如：

data := []byte(`{"id":9007199254740993}`)

var result map[string]any

json.Unmarshal(data, &result)

fmt.Printf("%.0f\n", result["id"])

输出：

9007199254740992

可以发现，原本的数字发生了变化。

这是因为 float64 无法精确表示所有超过 2^53 的整数。

使用 UseNumber

可以通过 json.Decoder.UseNumber() 保留数字的原始文本表示：

decoder := json.NewDecoder(
    strings.NewReader(`{"id":9007199254740993}`),
)

decoder.UseNumber()

var result map[string]any

if err := decoder.Decode(&result); err != nil {
    return
}

id := result["id"].(json.Number)

fmt.Println(id.String())

输出：

9007199254740993

这样就不会因为自动转换为 float64 而丢失精度。

如果需要转换成整数，还可以使用：

num, err := id.Int64()
if err != nil {
    return
}

fmt.Println(num)

需要注意，Int64() 只能处理 int64 范围内的整数。

小结

当使用 map[string]any 解析包含大整数的 JSON 时，可以使用：

decoder.UseNumber()

让数字以 json.Number 类型保存，避免默认转换成 float64 导致精度丢失。

这个技巧特别适合：

• 订单 ID、用户 ID 解析
• 第三方 API 数据处理
• 金融金额及高精度数字处理
• 动态 JSON 数据解析

尤其是接口中存在较大整数时，这个细节很容易被忽略。