JSON 解析中字符串数字与原始数字的类型区别详解-Golang-PHP中文网

JSON 解析中字符串数字与原始数字的类型区别详解

Go 的 json.Unmarshal 严格遵循 JSON 规范：带双引号的 "1" 是字符串，不带引号的 1 才是 JSON 数字，因此只有后者才能被正确反序列化为 float64 等数值类型。

go 的 `json.unmarshal` 严格遵循 json 规范：带双引号的 `"1"` 是字符串，不带引号的 `1` 才是 json 数字，因此只有后者才能被正确反序列化为 `float64` 等数值类型。

在 Go 中使用 encoding/json 包解析 JSON 数据时，一个常见误区是误将带引号的数字（如 "1"）当作数值处理。实际上，根据 RFC 8259 定义，JSON 中的数字（number）必须不带引号；而任何用双引号包围的内容（如 "1"、"3.14"、"true"）都属于字符串（string）类型，无论其内容是否“看起来像数字”。

例如：

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    // ✅ 正确：JSON 数字（无引号）→ 可成功反序列化为 float64
    data1 := []byte(`{"value": 42}`)
    var v1 struct{ Value float64 }
    json.Unmarshal(data1, &v1)
    fmt.Printf("Numeric JSON: %.0f\n", v1.Value) // 输出：42

    // ❌ 错误：JSON 字符串（有引号）→ 不会自动转为数字；Value 保持 0（零值）
    data2 := []byte(`{"value": "42"}`)
    var v2 struct{ Value float64 }
    json.Unmarshal(data2, &v2)
    fmt.Printf("String JSON: %.0f\n", v2.Value) // 输出：0
}

⚠️ 注意：json.Unmarshal 不会自动进行字符串到数字的类型转换。这是设计使然——Go 强调显式性与安全性，避免隐式转换引发的歧义或静默错误（如 "1e5"、"0x1F" 或非数字字符串 "abc" 的处理边界问题）。

如需支持带引号的数字字符串（即容忍“宽松 JSON”格式），可采用以下方案之一：

jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载

自定义类型 + UnmarshalJSON 方法（推荐）：

type NumericFloat64 float64

func (n *NumericFloat64) UnmarshalJSON(data []byte) error {
    // 先尝试按字符串解析
    var s string
    if err := json.Unmarshal(data, &s); err == nil {
        if f, err := strconv.ParseFloat(s, 64); err == nil {
            *n = NumericFloat64(f)
            return nil
        }
    }
    // 再尝试按原生数字解析
    var f float64
    if err := json.Unmarshal(data, &f); err == nil {
        *n = NumericFloat64(f)
        return nil
    }
    return fmt.Errorf("cannot unmarshal %s into float64", string(data))
}