Go json.Number Int64 为什么会返回语法错误

json.Number.Int64() 返回语法错误，通常不是 JSON 无法解析，而是数字原文不符合十进制整数格式。json.Number 会保留 JSON 数字字面量；Int64() 内部直接调用 strconv.ParseInt(string(n), 10, 64)。因此 1.5、1e3 都是合法 JSON 数字，却不是 ParseInt 接受的整数文本。

如果原文是纯整数但超过 int64 范围，返回的则是范围错误。先查看 Number.String() 保存的原文，再决定使用 Int64、Float64，还是把数字继续按字符串交给高精度方案处理。

为什么解码成功，Int64 仍失败

Decoder.UseNumber() 的作用，是让解码到 interface{} 的 JSON 数字保存为 json.Number，而不是立刻变成 float64。它保留原始文本，但不会承诺每个数字都能转换成整数。

dec := json.NewDecoder(strings.NewReader(`{"count": 1e3}`))
dec.UseNumber() // 动态 JSON 中的数字保留为 json.Number

var payload map[string]any
if err := dec.Decode(&payload); err != nil {
    return fmt.Errorf("解析 JSON: %w", err)
}

number, ok := payload["count"].(json.Number)
if !ok {
    return errors.New("count 不是 JSON 数字") // 先确认动态值类型
}

value, err := number.Int64()
if err != nil {
    // 1e3 合法，但 ParseInt 不接受指数形式
    return fmt.Errorf("count 必须是十进制整数，原值 %q: %w", number.String(), err)
}

这解释了一个常见误区：1e3 在数学上等于 1000，不代表它的文本就是整数语法。Int64() 不会先计算指数再判断结果，也不会把小数自动截断。

区分 syntax 与 range

Int64() 返回的错误来自 strconv.ParseInt。小数点、指数标记或其他不符合整数语法的字符会触发 strconv.ErrSyntax；纯整数文本超过 -9223372036854775808 到 9223372036854775807 时会触发 strconv.ErrRange。

func parseRequiredInt64(n json.Number) (int64, error) {
    value, err := n.Int64()
    if err == nil {
        return value, nil
    }

    var numErr *strconv.NumError
    if errors.As(err, &numErr) {
        switch {
        case errors.Is(numErr.Err, strconv.ErrSyntax):
            // 小数或指数形式不符合接口的整数契约
            return 0, fmt.Errorf("必须填写普通十进制整数: %q", n.String())
        case errors.Is(numErr.Err, strconv.ErrRange):
            // 文本像整数，但数值超出 int64 可表示范围
            return 0, fmt.Errorf("整数超出 int64 范围: %q", n.String())
        }
    }
    return 0, fmt.Errorf("转换整数失败: %w", err)
}

应该怎么选择转换方式

不要为了解决语法错误先调用 Float64()，再强制转换成 int64。这种做法可能静默截断小数，也可能让较大的整数丢失精度。正确做法是先确定字段契约：只允许整数就拒绝小数和指数文本；允许科学计数法则采用能表达该契约的解析路径。

官方文档：https://pkg.go.dev/encoding/json#Number.Int64

相关问题

UseNumber 会校验数字能否放进 int64 吗？

不会。它只改变动态接口值的保存类型，让数字原文成为 json.Number；具体能否转为整数，要在调用 Int64() 时判断。

json.Number.String() 会规范化 1e3 吗？

不会。它返回保存的数字字面量文本，因此适合用于诊断、记录原输入，或交给其他精确解析方案。