Go中解析JSON时保留64位整数值-Golang-PHP中文网

Go中解析JSON时保留64位整数值

花韻仙語

发布： 2025-10-13 10:23:14

原创

160人浏览过

go中解析json时保留64位整数值

在Go语言中处理包含64位整数的JSON数据时，标准`json.Unmarshal`到`interface{}`可能导致精度丢失。本文将介绍两种有效策略来解决此问题：一是利用`json.Decoder`的`UseNumber()`方法将数字解析为`json.Number`字符串再手动转换；二是定义具有精确`uint64`或`int64`字段的Go结构体进行反序列化，确保数据完整性。

在Go语言中，当使用encoding/json包的json.Unmarshal函数将JSON数据解析到map[string]interface{}或[]interface{}时，默认情况下，JSON中的数字会被解析为Go的float64类型。对于不超出float64精度范围的整数，这通常不是问题。然而，当JSON中包含的整数值超出float64所能精确表示的范围（例如，大于2^53的64位整数）时，这种默认行为会导致精度丢失，从而无法准确获取原始的整数值。

例如，一个包含id: 4418489049307132905的JSON字段，如果直接解析到interface{}，其值可能会被转换为一个近似的浮点数，而不是原始的精确整数。为了解决这一问题，Go提供了两种主要的策略来确保64位整数在JSON解析过程中保持其原始精度。

方法一：使用 json.Decoder 和 UseNumber()

encoding/json包提供了一个Decoder类型，它允许我们对JSON解析过程进行更精细的控制。通过结合Decoder的UseNumber()方法，我们可以指示解码器将所有JSON数字解析为json.Number类型，而不是默认的float64。json.Number本质上是一个字符串类型，它保留了数字的原始文本表示，从而避免了任何精度损失。之后，我们可以手动将json.Number转换回Go的int64或uint64类型。

以下是具体实现：

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "strconv"
)

func main() {
    body := []byte(`{"tags":[{"id":4418489049307132905},{"id":4418489049307132906}]}`)

    // 使用map[string]interface{}来接收数据，但通过Decoder控制数字类型
    dat := make(map[string]interface{})
    d := json.NewDecoder(bytes.NewBuffer(body))
    d.UseNumber() // 关键：将所有数字解析为json.Number类型

    if err := d.Decode(&dat); err != nil {
        panic(err)
    }

    tags := dat["tags"].([]interface{})
    for i, tag := range tags {
        // 从interface{}中取出map，再取出id字段
        idValue := tag.(map[string]interface{})["id"]

        // 断言idValue为json.Number类型
        n, ok := idValue.(json.Number)
        if !ok {
            fmt.Printf("tag %d id is not a json.Number\n", i)
                continue
        }

        // 将json.Number转换为uint64
        i64, err := strconv.ParseUint(string(n), 10, 64)
        if err != nil {
            fmt.Printf("Error parsing tag %d id to uint64: %v\n", i, err)
            continue
        }
        fmt.Printf("tag: %d id: %d (type: %T)\n", i, i64, i64)
    }
}

登录后复制

在上述代码中，d.UseNumber()是核心。它使得id字段被解码为json.Number。随后，我们通过类型断言获取json.Number，并使用strconv.ParseUint（如果数字为无符号）或strconv.ParseInt（如果数字为有符号）将其转换为所需的64位整数类型。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

方法二：定义精确的Go结构体

另一种更Go风格且通常更推荐的方法是，预先定义一个Go结构体，其字段类型与JSON数据中的类型精确匹配。当JSON中的整数字段已知为64位整数时，可以直接在结构体中将其定义为uint64或int64类型。json.Unmarshal在解析到具体结构体时，会尝试将JSON值直接匹配到结构体字段的类型，从而避免了中间的float64转换。

这种方法提供了更好的类型安全性和代码可读性，并且通常更容易维护。

package main

import (
    "encoding/json"
    "fmt"
)

// 定义与JSON结构匹配的Go结构体
type Tag struct {
    ID uint64 `json:"id"` // 明确指定id为uint64类型
}

type Payload struct {
    Tags []Tag `json:"tags"`
}

func main() {
    body := []byte(`{"tags":[{"id":4418489049307132905},{"id":4418489049307132906}]}`)

    var payload Payload
    if err := json.Unmarshal(body, &payload); err != nil {
        panic(err)
    }

    for i, tag := range payload.Tags {
        fmt.Printf("tag: %d id: %d (type: %T)\n", i, tag.ID, tag.ID)
    }
}

登录后复制

在这个示例中，我们定义了Tag结构体，其中ID字段直接声明为uint64。当json.Unmarshal解析到Payload结构体时，它会直接将JSON中的id值解析为uint64，完全避免了浮点数转换。这种方法在JSON结构相对固定时尤为强大和便捷。

注意事项与总结

JavaScript兼容性：需要注意的是，如果您的应用程序涉及到JavaScript前端，并且JSON数据需要在JavaScript中处理，那么即使在Go中成功保留了64位整数，JavaScript也可能无法精确处理这些值。JavaScript中的数字类型是IEEE 754双精度浮点数，它只能精确表示到2^53的整数。大于此范围的64位整数在JavaScript中进行标准解析时仍会面临精度损失。在这种跨语言交互的场景下，一种常见的做法是将64位整数在JSON中编码为字符串，以确保在所有环境中都能保持精度。
方法选择：
- 定义精确结构体（方法二）通常是首选。它提供了类型安全、代码清晰且易于维护的优点，特别适用于JSON结构已知且相对稳定的场景。
- 使用json.Decoder和UseNumber()（方法一）在处理动态或未知JSON结构时非常有用，例如当您需要解析到map[string]interface{}但又希望保留数字精度时。这种方法提供了更大的灵活性，但需要额外的类型断言和字符串转换步骤。