Go gojq 的大整数计算与先转 float64 有什么区别

处理订单号、计数器或高精度金额时，gojq 与先转 float64 的结果可能完全不同。结论先说：gojq 会保留大整数并支持任意精度整数计算；而 float64 只有 53 位有效二进制精度，超过 2^53 后，整数之间不再都能精确区分。要做精确比较、加减乘或序列化，先不要把数字转成 float64。

先分清 gojq 保留整数与 float64 的边界

gojq 是 jq 的纯 Go 实现，官方示例直接展示了大数字保持精度以及任意精度整数阶乘。它的关键不是“输出时把数字打印得更长”，而是计算过程中没有先把整数压进双精度浮点数。

float64 的安全整数边界通常写成 2^53，也就是 9007199254740992。边界之外，两个相邻的十进制整数可能映射到同一个浮点值，所以“先转再比较”会把不同的业务编号当成相同值。

用 gojq 直接完成大整数运算

把输入保持为数字，让过滤器直接完成运算。下面的命令只用于说明处理方式；其中的中文注释解释参数目的，实际部署时可把输入改成文件或管道。

# 让 gojq 直接处理大整数，避免先经过 float64
printf '%s\n' '{"count":9007199254740993}' \
  | gojq '.count + 2'

# 用比较表达式确认结果仍高于 float64 安全整数边界
printf '%s\n' '{"count":9007199254740993}' \
  | gojq 'if .count > 9007199254740992 then "保留整数" else "需要排查" end'

运算式中的数字常量和输入字段都留在 gojq 的数值路径中，适合精确的计数和边界判断。不要把这类值先交给会默认解码为 float64 的中间层，再把结果传回 gojq。

在 Go 代码中避免过早转成 float64

嵌入 gojq 时，建议把“精确整数”和“近似小数”分成两条明确路径。下面的示例用库 API 编译过滤器，并保留一个大整数输入；实际项目还应根据输入来源决定是否先做 schema 检查。

package main

import (
    "fmt"
    "github.com/itchyny/gojq"
)

func main() {
    // 过滤器直接读取 count，避免业务层先把它转换为 float64。
    query, err := gojq.Parse(".count + 2")
    if err != nil {
        panic(err)
    }
    code, err := gojq.Compile(query)
    if err != nil {
        panic(err)
    }

    // 保留整数语义；真实服务应把解析错误和结果类型写入日志。
    input := map[string]interface{}{"count": int64(9007199254740993)}
    iter := code.Run(input)
    value, ok := iter.Next()
    if !ok {
        panic("gojq 没有返回结果")
    }
    fmt.Println(value)
}

如果输入值可能超过 int64，不要为了省事强转为 float64。可以在入口保留字符串，或使用能承载任意精度整数的解析方案，再把转换责任放在明确的边界上。只有当下游算法确实接受误差时，才把值转成浮点数。

建立上线前的精度排查清单

遇到“大整数偶尔相等”或输出末尾变化时，按链路定位，不要先改过滤器表达式：

1. 输入层：确认 JSON 字段是数字还是字符串，检查是否经过默认 float64 解码。
2. 计算层：在 gojq 中直接比较原值与边界值，避免中途调用泛型数值转换。
3. 接口层：检查 Go 结构体、消息队列和数据库驱动的字段类型。
4. 输出层：对序列化后的文本做位数比对；若下游只支持浮点，先明确记录舍入策略。

回滚时优先撤掉“统一转 float64”的改动，恢复原始整数或字符串通路，再补边界样例。告警可以关注数值位数变化、比较结果翻转和序列化前后摘要不一致；这些信号比单看一条错误日志更容易定位责任边界。

相关问题

gojq 会不会把所有 JSON 数字都当成整数？

不会。整数和带小数的数字语义不同，关键是不要在进入 gojq 前把本来精确的整数统一转换成浮点数。

超过 2^53 就一定不能用 float64 吗？

不是绝对禁止，而是必须接受近似语义。统计、比例和容差计算可以使用；订单号、计数器和精确金额不应依赖它区分相邻整数。

gojq CLI 与 Go 库的处理原则一样吗？

原则一样：在精确计算链路中保持整数，到必须近似的业务边界再转换，并为边界值准备回归样例。