Go JSON反序列化科学计数法数值为int32报错解决方案

两种行为的差异来自处理阶段的不同，和运行时逻辑无关：

• 代码中直接编写var i int32 = 3.898733e+06属于编译期常量处理：无类型浮点常量会在编译阶段被校验，只要数值可以无损转换为目标整数类型，编译器会直接完成常量折叠和类型转换，整个过程不会走到运行时的解析逻辑。
• json.Unmarshal是纯运行时逻辑：标准库JSON解析器遇到带e/E指数标记的数字时，会默认判定为浮点类型，不会自动做浮点到整数的隐式转换，直接绑定到int32字段就会抛出类型不匹配错误。这和strconv.ParseInt不支持直接解析科学计数法字符串的行为是一致的。

int32的取值范围完全在float64的精确整数表示区间内（float64可无损表示2^{53以内的所有整数，远大于int32的最大值2}31-1），因此用float64做中转不会出现精度损失，可根据业务场景选择以下方案：

方案1：float64临时中转（改动最小） #

适合只有少量字段需要处理的简单场景，将对应字段临时定义为float64类型接收，反序列化完成后手动转换为int32即可：

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

type Test struct {
    Key   string
    Value float64
}

func main() {
    data := []byte("{\"Key\": \"derp\", \"Value\": 3.898733e+06}")
    var t Test
    err := json.Unmarshal(data, &t)
    if err != nil {
        panic(err)
    }
    intVal := int32(t.Value)
    // 可选校验：防止接口返回非整数值
    if math.Abs(t.Value-float64(intVal)) > 1e-6 {
        panic("value is not a valid integer")
    }
    fmt.Printf("Parsed result: %d\n", intVal) // 输出：Parsed result: 3898733
}

方案2：自定义类型实现反序列化接口（复用性最高） #

如果项目中有多处需要解析该格式的整数，可以自定义支持科学计数法解析的int32类型，实现json.Unmarshaler接口，业务层直接替换字段类型即可，无需重复写转换逻辑：

type SciInt32 int32

func (i *SciInt32) UnmarshalJSON(data []byte) error {
    var f float64
    if err := json.Unmarshal(data, &f); err != nil {
        return err
    }
    *i = SciInt32(f)
    return nil
}

// 使用时直接替换原int32字段
type Test struct {
    Key   string
    Value SciInt32
}

方案3：使用json.Number处理（适合动态结构场景） #

如果不方便修改结构体字段类型，或者需要处理结构动态变化的JSON，可以通过Decoder开启UseNumber模式，将所有数字统一解析为json.Number（本质是原始数字字符串），再按需转换为目标类型：

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

func main() {
    data := []byte("{\"Key\": \"derp\", \"Value\": 3.898733e+06}")
    decoder := json.NewDecoder(bytes.NewReader(data))
    decoder.UseNumber()
    
    var raw map[string]interface{}
    if err := decoder.Decode(&raw); err != nil {
        panic(err)
    }
    f, err := raw["Value"].(json.Number).Float64()
    if err != nil {
        panic(err)
    }
    
    t := Test{
        Key:   raw["Key"].(string),
        Value: int32(f),
    }
    fmt.Printf("Data: %+v\n", t)
}

如果业务场景涉及超过2^53的大整数，禁止使用float64中转，会出现精度丢失。这种情况需要自行实现科学计数法字符串到整数的直接解析逻辑，或者协调接口方将大整数作为字符串类型返回。

内容的提问来源于stack exchange，提问作者Woody1193