Go JSON 为什么数字字段变成 float64

如果你把 JSON 解码到 map[string]any，再打印数字字段的类型，看到的通常是 float64。这不是 JSON 文本被偷偷改写，而是 Go 标准库在目标类型是 interface{} 时的默认映射：JSON number 没有单独的整数类型，encoding/json 选择用 float64 承载它。固定字段优先用结构体；字段确实动态时，再用 Decoder.UseNumber() 保留数字文本。

Go 为什么把 JSON 数字放进 interface{} 后变成 float64

问题通常出现在接口返回字段不固定的场景。对象会进入 map[string]any，数组会进入 []any，字符串、布尔值和空值分别进入 string、bool 和 nil；数字则统一进入 float64。因此下面的断言是成立的：

var payload map[string]any
err := json.Unmarshal([]byte(`{"count": 12}`), &payload)
if err != nil {
    return err // 输入不是合法 JSON 时先返回错误
}
count, ok := payload["count"].(float64)
if !ok {
    return fmt.Errorf("count 的实际类型不是 float64") // 不要盲目断言
}
fmt.Println(count) // 12

这里的 12 在内存中是浮点值。若直接写 payload["count"].(int)，会触发类型断言失败，因为“数值看起来像整数”不等于“动态值的 Go 类型是 int”。

固定字段用结构体，让 JSON 契约决定 Go 类型

如果字段名和类型是接口契约的一部分，不要为了省事先解成 map[string]any。结构体会让解码器按字段声明转换，调用代码也不需要到处写类型断言。

type Order struct {
    ID    int64   `json:"id"`
    Total float64 `json:"total"`
}

var order Order
if err := json.Unmarshal(data, &order); err != nil {
    return fmt.Errorf("解析订单 JSON: %w", err) // 保留原始错误，便于定位字段
}
fmt.Println(order.ID, order.Total) // ID 是 int64，Total 是 float64

这条路径适合稳定 API、数据库记录和明确的配置文件。数字超过 int64 范围、带小数却映射到整数，或输入类型完全不匹配时，应该让解码报错，而不是用后续断言掩盖数据问题。

字段动态时用 UseNumber 保留数字语义

当对象键集合不固定、但又不能接受数字先变成浮点数，可以用 Decoder：

dec := json.NewDecoder(bytes.NewReader(data))
dec.UseNumber() // 让 interface{} 中的数字保留为 json.Number

var payload map[string]any
if err := dec.Decode(&payload); err != nil {
    return fmt.Errorf("解析动态 JSON: %w", err) // 解析错误仍要向上返回
}
number, ok := payload["count"].(json.Number)
if !ok {
    return fmt.Errorf("count 不是 JSON number") // 兼容字段缺失或类型变化
}
count, err := number.Int64()
if err != nil {
    return fmt.Errorf("count 不是可表示的 int64: %w", err) // 转换失败必须显式处理
}
fmt.Println(count)

UseNumber 解决的是先按什么类型保存的问题，不会替你决定业务类型。需要小数时调用 Float64()；需要整数时调用 Int64()，并检查错误。若数字只需要原样转发，使用 number.String() 可以保留 JSON 数字字面量。

用这张表判断该选哪条解码路径

特别要留意大整数：一旦先落到 float64，再转回整数可能已经失去精度。对订单号、雪花 ID、外部系统流水号这类值，固定字段使用 int64，动态字段使用 UseNumber，不要用“先转 float64 再转 int64”的补救方式。

相关问题

结构体字段写成 int，JSON 小数会怎样？

解码时会返回类型错误。它不是自动四舍五入；如果业务允许小数，应把字段定义为 float64 或使用自定义类型处理。

UseNumber 会让所有数字都变成字符串吗？

不会。它只在动态目标中把数字保存为 json.Number，这是一个保留字面量的类型；最终仍由你选择转成整数、浮点数或字符串。

为什么同一字段有时是 float64，有时是 int64？

通常是两条解码路径混用了：动态对象默认得到 float64，结构体字段则按声明得到 int64。统一入口的目标类型即可减少这种分支。