当前位置:

首页 > 编程开发 > 详解Go语言中json转换int64精度丢失的问题解决

详解Go语言中json转换int64精度丢失的问题解决

GoldWave 简体中文
GoldWave 简体中文

一款功能相当强大的录音及音频编辑软件,不仅可以编辑音频,而且还可以录音,功能丰富,操作简单,使用方便,实用性强,并且占用电脑内存小,运行速度快,不卡顿电脑,使电脑系统保持良好的运行状态。支持许多格式的音频文件,包括WAV、OGG、VOC、IFF、AIFF、

立即下载
2026-08-22
图形多媒体 音频工具 GoldWave 音频制作 视频渲染 制作软件 goldwave教程

Go语言JSON解析默认将数字转为float64,导致大整数精度丢失。可通过json.Number暂存原始文本、json:",string"标签自动转换或自定义UnmarshalJSON方法解决,三种方案分别适用于不同场景。

本文目录

    Go语言里处理JSON转int64的时候,有个细节特别容易让人踩坑——精度丢失。这事儿说大不大,但一旦碰上,排查起来还挺头疼的。原因其实不复杂:JSON标准里根本没有专门定义整数类型,它用double(双精度浮点数)来兜底所有数字。而float64在表示超大整数时,天然就存在精度瓶颈。

    详解Go语言中json转换int64精度丢失的问题解决

    导致精度丢失的情况

    通常来说,下面这几种情况最容易中招:

    1. 大整数:如果JSON里的数字超出了int64的范围(-2^63 到 2^63-1),转换时精度说丢就丢。

    2. 浮点数:如果数字本身带小数,强转成int64时,小数点后面的部分自然会被截掉。

    3. 负数:和正数一样,一旦超过表示范围,同样逃不掉精度损失。

    解决方法

    那么,怎么避开这个坑呢?有几种常见的做法。

    1. 使用 json.Number 类型

    解析JSON时,用json.Number这个类型来“暂存”原始的数字文本,之后再按需转成int64。这个方法的关键在于延迟了类型转换,从而保留了原始精度。

    import (
        "encoding/json"
        "fmt"
        "math/big"
    )
    func main() {
        jsonStr := `{"number": "9223372036854775808"}` // 超出int64范围的数字
        var data map[string]json.Number
        err := json.Unmarshal([]byte(jsonStr), &data)
        if err != nil {
            panic(err)
        }
        number := data["number"]
        num := new(big.Int)
        num, ok := number.Int64()
        if !ok {
            num, _ = new(big.Int).SetString(string(number), 10)
            fmt.Printf("转换为big.Int: %s\n", num.String())
        } else {
            fmt.Printf("转换为int64: %d\n", num)
        }
    }

    2. 使用第三方库

    像go.mongodb.org/mongo-driver/bson这类库,内置了更灵活的整数处理机制,有时候能直接解决问题。

    3. 手动预处理

    在调用JSON解析之前,先手动检查数字大小。一旦发现超出int64范围,可以提前做特殊处理。

    4. 约定JSON格式

    如果JSON数据由你控制,那就从源头约定好:确保所有数字都在int64的安全范围内,或者直接约定用字符串来表示大整数。

    jsoniter "github.com/json-iterator/go"
    func Test0008_Jsoniter_Marshal(t *testing.T) {
        order := Order{
           Id:         baseutils.SnowflakeNextVal(),
           OrderId:    "12345678",
           Money:      99.99,
           CreateTime: time.Now(), // 2023-12-05T16:19:33.943989108+08:00
           Extend:     map[string]string{"name": "张三"},
        }
        // 使用1:直接转成字符串
        jsonStr, _ := jsoniter.MarshalToString(order)
        fmt.Println("jsonStr:", jsonStr)
        // 使用2:直接转成字节数组
        jsonByteArr, _ := jsoniter.Marshal(order)
        fmt.Println("jsonByteArr:", jsonByteArr)
        // 使用3:反序列化之字符串转结构体
        str := `{"id":666, "order_id":"12345678", "money": 99.99, "create_time":"2023-12-05T16:19:33.943989108+08:00", "extend":{"name":"张三"}}`
        var order2 Order
        err := jsoniter.UnmarshalFromString(str, &order2)
        if err != nil {
           fmt.Println("err2:", err)
        }
        fmt.Println("order2:", order2)
        // 使用4:反序列化之字节数组转结构体
        var order3 Order
        var jsonNew = jsoniter.ConfigCompatibleWithStandardLibrary
        // 自适应类型
        extra.RegisterFuzzyDecoders()
        err = jsonNew.Unmarshal(jsonByteArr, &order3)
        if err != nil {
           fmt.Println("err3:", err)
        }
        fmt.Println("order3:", order3)
    }
    ​​​​​​​order3: {572839995925069824 12345678 99.99 2024-04-29 17:41:37.8819085 +0800 CST map[name:张三]}

    知识扩展

    说白了,Go里JSON转换int64精度丢失这个问题的根子,就在encoding/json默认把JSON数字解析成float64上。float64只能精确表达±2^53以内的整数,一旦越界,精度就开始打折扣了。

    业内针对这个问题,主要有三种比较成熟的方案。每个方案各有侧重,你可以根据实际场景来选。

    方案一:使用 json.Number (最轻量、最精准)

    这个方案的核心思路是“延迟转换”。把可能包含大整数的字段声明为json.Number类型,它本质上就是个字符串,只负责暂存原始数字文本。之后你有需要了,再手动调用.Int64()方法拿到精确的int64值。

    package main
    import (
    	"encoding/json"
    	"fmt"
    )
    type MyData struct {
    	// 将可能超限的整数字段声明为 json.Number
    	LargeID json.Number `json:"id"`
    }
    func main() {
    	jsonStr := `{"id": 9223372036854775807}`
    	var data MyData
    	if err := json.Unmarshal([]byte(jsonStr), &data); err != nil {
    		panic(err)
    	}
    	// 安全地将 json.Number 转换为 int64
    	id, err := data.LargeID.Int64()
    	if err != nil {
    		panic(err) // 处理转换错误
    	}
    	fmt.Printf("转换后的 int64 值: %d\n", id)
    }

    关键点: json.Number字段必须手动调用.Int64()方法,这个步骤不能省,否则拿不到精确值。

    方案二:使用 json:",string" 标签 (最优雅、最常用)

    这个方案利用结构体标签,让encoding/json在编解码时自动完成JSON字符串和Go数值之间的双向转换。尤其适合前端(比如Ja vaScript)只接收字符串的场景。

    package main
    
    import (
    	"encoding/json"
    	"fmt"
    )
    
    type MyData struct {
    	// 使用 json:",string" 标签,让 ID 在 JSON 中以字符串形式传递
    	LargeID int64 `json:"id,string"`
    }
    
    func main() {
    	jsonStr := `{"id": "9223372036854775807"}`
    	var data MyData
    	if err := json.Unmarshal([]byte(jsonStr), &data); err != nil {
    		panic(err)
    	}
    	fmt.Printf("Unmarshal 得到的 int64 值: %d\n", data.LargeID)
    }

    方案三:自定义 UnmarshalJSON 方法 (终极可控)

    这种方案通过实现json.Unmarshaler接口,让你完全掌控自定义类型的解析过程。你可以把解析逻辑封装成独立类型,然后在需要的地方复用。

    package main
    
    import (
    	"encoding/json"
    	"fmt"
    	"strconv"
    )
    
    // 定义一个新的类型,并为其实现 UnmarshalJSON 接口
    type PreciseInt int64
    
    func (pi *PreciseInt) UnmarshalJSON(b []byte) error {
    	// 1. 先解析到 json.Number
    	var n json.Number
    	if err := json.Unmarshal(b, &n); err != nil {
    		return err
    	}
    	// 2. 再从 json.Number 安全地转换为 int64
    	i, err := n.Int64()
    	if err != nil {
    		return err
    	}
    	*pi = PreciseInt(i)
    	return nil
    }
    
    type MyData struct {
    	LargeID PreciseInt `json:"id"`
    }
    
    func main() {
    	jsonStr := `{"id": 9223372036854775807}`
    	var data MyData
    	if err := json.Unmarshal([]byte(jsonStr), &data); err != nil {
    		panic(err)
    	}
    	fmt.Printf("转换后的 int64 值: %d\n", data.LargeID)
    }

    方案对比与选择建议

    为了帮你做个更直观的判断,这里整理了张对比表:

    对比维度方案一:json.Number方案二:json:",string" 标签方案三:自定义 UnmarshalJSON
    核心机制使用 json.Number 类型暂存原始 JSON 数字字符串利用标签 ,string 实现 JSON 字符串与 Go 数值的自动转换为自定义类型实现 json.Unmarshaler 接口,完全掌控解析过程
    代码侵入性低:只需修改结构体字段类型低:只需在结构体标签中添加 ,string中等:需要定义新类型并实现接口
    对前端的影响无:前端接收到的仍是 Number有:前端需处理 string 类型可控:可根据实现逻辑决定 JSON 中的格式
    性能开销中等:涉及额外类型转换,有约 2-3 倍开销低:性能损耗极小中等:类似 json.Number,取决于实现
    灵活性与扩展性低:功能相对单一低:功能单一极高:可根据需求定制任意逻辑
    推荐场景处理动态结构或第三方 API 的 JSON 数据时与Ja vaScript 前端交互时的首选方案需要对特定字段进行复杂校验、转换或类型限制时

    总结一下:

    • 和前端(尤其是Ja vaScript)打交道,方案二 (json:",string" 标签) 最直接、最优雅。
    • 如果遇到结构不固定的JSON数据,方案一 (json.Number) 的灵活性是最好的。
    • 要是前两个都满足不了你的特殊需求,方案三 (自定义UnmarshalJSON) 能给你终极的掌控感。
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    苹果手机使用教程
    苹果手机使用教程

    新机到手第一步,自然是激活Apple ID、设置面容ID和锁屏密码;之后可以把主屏幕精简到只剩最常用的几个App,其余的都交给“App资源库”打理;至于隐私,给App授权照片时,现在有了“仅限选定照片”这个更精细的选择;如果觉得主屏幕页面太多,还可以把不常用的隐藏起来,既清爽又不影响功能。 刚拿到一

    谷歌浏览器Mac版入口
    谷歌浏览器Mac版入口

    谷歌浏览器Mac版官方安装指南 谷歌浏览器Mac版官方安装入口是https://www.google.com/chrome/,需macOS 12+系统、500MB空间,下载.dmg后拖入应用程序安装,支持多设备同步、性能优化与隐私保护功能。 苹果电脑Chrome的安装入口究竟在哪里?这个问题最近可是

    谷歌翻译官网网页版入口地址
    谷歌翻译官网网页版入口地址

    多语种覆盖能力 首先,它支持超过100种语言之间的即时互译,从全球主流语系到冰岛语、拉脱维亚语这类区域性小语种,都能找到对应方案,覆盖范围相当广泛。对于不确定源语言的情况,系统自带的语种自动识别功能就派上了大用场,粘贴文本后瞬间就能判定语种并启动翻译,操作门槛极低。 面对德语、法语、日语这些语法结构

    谷歌浏览器如何翻译整个网页
    谷歌浏览器如何翻译整个网页

    用好浏览器自带翻译,跨语言浏览其实很简单 浏览外文网站时,语言不通确实是道坎儿。其实,谷歌浏览器自带了一套相当便捷的翻译方案,能帮你把整个网页变成熟悉的语言,基本上不需要离手浏览器。 (本文操作基于 Dell XPS 13,Windows 11 环境下的谷歌浏览器) 一、最直接的入口:地址栏翻译按钮

    中国电信官网在线访问入口
    中国电信官网在线访问入口

    中国电信官网在线访问入口与核心功能解析 对于许多电信用户来说,高效便捷地找到官方服务入口并进行在线办理,是日常生活中的高频需求。今天我们就来详细拆解一下中国电信的官方网站,看看它究竟能为用户带来哪些便利。 访问入口明确且统一:中国电信官网的在线访问地址是 https://www.189.cn。这个入

    百度识图在线使用
    百度识图在线使用

    百度识图无需下载应用,通过浏览器访问官网即可使用 想知道一张图片的来历,或者搞不清楚眼前的东西是什么?其实有个非常便捷的工具——百度识图。它最妙的一点在于,完全不需要你在手机上下载任何应用,直接用浏览器打开官网就能搞定图片搜索和识别。 如何进入百度识图页面 方法再简单不过:无论你用的是电脑还是手机,

    google浏览器拓展插件安装
    google浏览器拓展插件安装

    想在Chrome浏览器里装些好用的小工具,但发现插件来源复杂、操作步骤也不少,是不是有点无从下手?其实,只要搞懂几个核心路径,给Chrome添加新功能这件事,完全可以变得轻松流畅。下面,就为你梳理清楚安装第三方扩展的全套方法。 一、通过Chrome网上应用店安装插件 最稳妥、最省心的方式,自然是走官

    火狐浏览器有哪些设置功能
    火狐浏览器有哪些设置功能

    火狐浏览器五大核心设置功能:解锁高效、安全与个性化体验 火狐浏览器功能强大,但如果不仔细挖掘,很多能大幅提升效率和安全性的设置可能就“藏着掖着”了。这就好比拥有一台高性能设备,却只用了基础模式。那么,如何把它调整到最顺手、最安全的状态?接下来,我们就聚焦于当前版本(截至2025年末)最关键的五大设置

    如何在电脑上运行Google
    如何在电脑上运行Google

    如何在电脑上运行Google Play?3个在PC使用谷歌商店的高效方案 想在Windows电脑上打开Google Play商店,直接安装安卓应用或游戏?这个想法很自然,但得清楚一点:谷歌并未为桌面操作系统提供官方原生支持。不过别担心,绕过这个限制,已经有几条成熟且高效的路径被验证可行。下面我们就来

    chrome搜索免验证入口
    chrome搜索免验证入口

    Chrome官方免验证入口为https://www.google.cn/chrome/,提供全平台安装包、免登录即用、本地化安全机制及引擎级性能优化。 到底该去哪里找正版、免费且无需繁琐验证的Chrome浏览器入口?这个问题困扰了不少网友。今天,我们就来直通核心,为大家详细拆解Chrome引擎的官方

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    即将离开本站
    您即将前往第三方网站,请确认是否继续?