解决Go encoding/json 将JSON大数字解析为浮点数的问题

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

解决Go encoding/json 将JSON大数字解析为浮点数的问题

2025-11-29

浏览次数：次

返回列表

解决Go encoding/json 将JSON大数字解析为浮点数的问题

go语言在处理json中的大整数时，默认行为可能导致精度丢失，将其解析为浮点数。本文将深入探讨这一问题，并提供一种专业且可靠的解决方案：利用`json.decoder`的`usenumber()`方法，将数字类型解析为`json.number`字符串，从而有效避免数据类型转换带来的精度问题，确保json数据在go程序中精确地序列化与反序列化。

Go语言JSON处理中的数字类型转换问题

在使用Go语言的encoding/json包进行JSON数据的序列化（Marshal）和反序列化（Unmarshal）时，如果目标类型是interface{}，json包会尝试将JSON中的数字类型自动转换为Go的float64类型。对于不带小数点的整数，尤其是当它们的数值较大时，这种自动转换可能导致数据以科学计数法表示，或者更严重地，由于浮点数的精度限制而丢失原始数值的精确性。

例如，考虑以下JSON字符串：

{
    "id": 12423434,
    "Name": "Fernando"
}

当使用json.Unmarshal将其反序列化到一个interface{}类型的变量，再将其断言为map[string]interface{}时，id字段的值会被解析为float64。随后，如果再次将其序列化回JSON字符串，id字段可能会以浮点数形式（例如1.2423434e+07）出现，从而改变了原始数据的表示形式。

以下是导致此问题的示例代码：

package main

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

func main() {
    // 原始JSON字符串
    var b = []byte(`
        {
        "id": 12423434,
        "Name": "Fernando"
        }
    `)

    // 反序列化到 interface{}
    var f interface{}
    json.Unmarshal(b, &f)

    // 断言为 map[string]interface{}
    m := f.(map[string]interface{})

    // 打印map，可见id已变为浮点数
    fmt.Println("反序列化后的map:", m)

    // 再次序列化map到JSON
    result, _ := json.Marshal(m)

    // 打印结果，id以浮点数形式出现
    os.Stdout.Write([]byte("再次序列化后的JSON: "))
    os.Stdout.Write(result)
    fmt.Println()
}

运行上述代码，输出结果将类似：

反序列化后的map: map[id:1.2423434e+07 Name:Fernando]
再次序列化后的JSON: {"Name":"Fernando","id":1.2423434e+07}

这清楚地表明，id字段的整数值在反序列化过程中被转换为了浮点数。

解决方案：使用 json.Decoder.UseNumber()

为了解决这个问题，并确保JSON中的数字（尤其是大整数）在Go程序中能够保持其原始的精确表示，我们可以利用encoding/json包提供的json.Decoder的UseNumber()方法。

UseNumber()方法会改变json.Decoder的默认行为：当遇到JSON中的数字时，它不再将其解析为float64，而是将其解析为json.Number类型。json.Number是一个字符串类型，它存储了数字的原始字符串表示形式。这样，无论数字有多大或多长，它的精确值都不会因浮点数转换而丢失。

N世界

一分钟搭建会展元宇宙

138 查看详情 N世界

以下是使用UseNumber()方法的示例代码：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "strings"
)

var data = `{
    "id": 12423434,
    "Name": "Fernando"
}`

func main() {
    // 创建一个 json.Decoder
    d := json.NewDecoder(strings.NewReader(data))

    // 启用 UseNumber()，使数字解析为 json.Number 类型
    d.UseNumber()

    var x interface{}
    // 使用 Decoder 进行反序列化
    if err := d.Decode(&x); err != nil {
        log.Fatal(err)
    }

    // 打印反序列化后的结果，可见id现在是 json.Number 类型（字符串表示）
    fmt.Printf("反序列化到 %#v\n", x)

    // 再次序列化回JSON
    result, err := json.Marshal(x)
    if err != nil {
        log.Fatal(err)
    }

    // 打印再次序列化后的JSON，id保持了原始整数形式
    fmt.Printf("再次序列化到 %s\n", result)
}

运行上述代码，输出结果将是：

反序列化到 map[string]interface {}{"id":"12423434", "Name":"Fernando"}
再次序列化到 {"Name":"Fernando","id":12423434}

从输出可以看出，id字段现在被正确地保持为整数形式，没有被转换为浮点数或科学计数法。

json.Number 的作用与优势

json.Number类型是一个string的别名，它在内部存储了JSON中数字的原始文本表示。当UseNumber()被启用后，所有JSON数字都会被解码成json.Number。

优势：

精度保持： 彻底避免了float64可能带来的精度丢失问题，对于需要处理精确大整数（如数据库ID、金融交易金额等）的场景至关重要。
灵活性： 即使在不知道JSON结构，必须使用interface{}进行反序列化的情况下，也能保证数字的精确性。
类型转换控制： 在获取json.Number后，你可以根据实际需求将其安全地转换为int64、float64甚至big.Int，而不是在反序列化阶段被强制转换为float64。json.Number提供了Int64()和Float64()等方法进行安全的类型转换。

例如，如果你想将json.Number转换为int64，可以这样做：

// 假设 m 是反序列化后的 map[string]interface{}
// 在启用UseNumber()后，x 会被解码为 map[string]interface{}
// 我们可以这样访问其元素：
if decodedMap, ok := x.(map[string]interface{}); ok {
    if val, ok := decodedMap["id"].(json.Number); ok {
        idInt, err := val.Int64()
        if err != nil {
            log.Fatalf("无法将id转换为int64: %v", err)
        }
        fmt.Printf("id (int64): %d\n", idInt)
    }
}

注意事项与最佳实践

json.Decoder 的使用： UseNumber()是json.Decoder的一个方法，这意味着你需要显式地创建一个json.Decoder实例来处理输入流，而不是直接使用json.Unmarshal()函数。
后续类型断言： 当你使用UseNumber()后，反序列化到interface{}中的数字类型将是json.Number。因此，在访问这些字段时，你需要进行相应的类型断言。
性能考量： 对于极度性能敏感的场景，如果JSON结构已知且数字范围在int64或float64可表示的范围内，直接定义结构体进行反序列化通常是最高效的方式。UseNumber()主要用于结构未知或需要处理超大整数的情况。
错误处理： 从json.Number转换为其他数字类型（如Int64()或Float64()）时，务必检查返回的错误，以处理潜在的溢出或格式不匹配情况。

总结

Go语言的encoding/json包在处理JSON数字时，默认将它们解析为float64，这可能导致大整数的精度问题。通过使用json.Decoder的UseNumber()方法，我们可以将这些数字作为json.Number类型（其原始字符串表示）进行反序列化，从而彻底避免精度丢失。这种方法在处理未知JSON结构或需要精确表示大整数的场景中尤为重要。理解并正确运用UseNumber()，将有助于构建更健壮、数据更精确的Go应用程序。

以上就是解决Go encoding/json 将JSON大数字解析为浮点数的问题的详细内容，更多请关注其它相关文章！

# 尤其是 # 南宁seo外包行者seo09 # 体检中心营销推广文案 # 武汉网站建设优化技术 # 餐饮行业推广营销找哪家 # 旅游网站广告的推广 # 湘潭360营销推广公司 # 淮安品牌网站定制优化 # seo获客技巧优化 # 阳江全平台营销推广 # seo外包接单渠道运营 # 创建一个 # 将是 # 我们可以 # js # 是一个 # 加载 # 转换为 # 将其 # 浮点数 # 序列化 # json处理 # 金融 # ai # go语言 # go # json