Go语言中JSON数组反序列化为结构体的正确方法-Golang-PHP中文网

Go语言中JSON数组反序列化为结构体的正确方法

本文详解如何在Go中正确将JSON数组（如金融行情数据）反序列化为结构体，重点解决因字段类型不匹配（如字符串误定义为整型）导致的json: cannot unmarshal string into Go value错误，并提供健壮的类型转换方案。

本文详解如何在go中正确将json数组（如金融行情数据）反序列化为结构体，重点解决因字段类型不匹配（如字符串误定义为整型）导致的`json: cannot unmarshal string into go value`错误，并提供健壮的类型转换方案。

在Go中处理外部API返回的JSON数据时，一个常见且易被忽视的陷阱是：JSON字段的实际类型与Go结构体字段声明类型不一致。以FXCM行情接口返回的Rates数组为例，其Bid、Ask、Spread等字段在JSON中均为带小数点的字符串（如"1.45492"、"2.00"），而非纯数字。若结构体中将其定义为int64或float64，标准json.Unmarshal（或ffjson）会直接报错：

panic: json: cannot unmarshal string into Go value of type main.MsgRatesArray

✅ 正确做法一：按JSON原始类型定义结构体

最简单、最安全的方式是严格遵循JSON Schema——将所有字符串字段声明为string类型：

type MsgRatesArray struct {
    RateQuote []MsgRateQuoteJson `json:"Rates"`
}

type MsgRateQuoteJson struct {
    SymbolName   string `json:"Symbol"`
    SymbolBid    string `json:"Bid"`     // ← JSON中是字符串，此处必须为string
    SymbolAsk    string `json:"Ask"`
    SymbolSpread string `json:"Spread"`
    SymbolPT     string `json:"ProductType"`
}

同时，修复代码中不合理的JSON预处理逻辑：
❌ 错误：ffjson.Marshal(result) —— Marshal用于将Go值转为JSON字节，而result已是合法JSON字符串；
✅ 正确：直接使用[]byte(result)转换：

jsonBytes2 := []byte(result) // 直接转字节切片，无需Marshal
err = ffjson.Unmarshal(jsonBytes2, &msg)
if err != nil {
    panic(err)
}

⚠️ 注意：原始代码中还存在JSON清洗逻辑（strings.Replace(..., "\",}", "\"}", -1)），这是为修复服务端返回的非法尾随逗号（trailing comma）。但更推荐使用容错性更强的库（如gjson）或正则精准替换，避免误伤有效数据。

✅ 正确做法二：自定义反序列化逻辑（推荐用于生产环境）

若需在反序列化阶段即完成类型转换（如将"1.45492"自动转为float64），应实现UnmarshalJSON方法，而非依赖字段类型强制匹配：

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

import "strconv"

type MsgRateQuoteJson struct {
    SymbolName   string  `json:"Symbol"`
    SymbolBid    float64 `json:"-"` // ← 忽略JSON直解，由UnmarshalJSON赋值
    SymbolAsk    float64 `json:"-"`
    SymbolSpread float64 `json:"-"`
    SymbolPT     int64   `json:"-"`
}

func (m *MsgRateQuoteJson) UnmarshalJSON(data []byte) error {
    // 临时用map解析，避免循环引用和类型冲突
    var raw map[string]string
    if err := ffjson.Unmarshal(data, &raw); err != nil {
        return err
    }

    m.SymbolName = raw["Symbol"]

    var err error
    if m.SymbolBid, err = strconv.ParseFloat(raw["Bid"], 64); err != nil {
        return fmt.Errorf("invalid Bid %q: %w", raw["Bid"], err)
    }
    if m.SymbolAsk, err = strconv.ParseFloat(raw["Ask"], 64); err != nil {
        return fmt.Errorf("invalid Ask %q: %w", raw["Ask"], err)
    }
    if m.SymbolSpread, err = strconv.ParseFloat(raw["Spread"], 64); err != nil {
        return fmt.Errorf("invalid Spread %q: %w", raw["Spread"], err)
    }
    if m.SymbolPT, err = strconv.ParseInt(raw["ProductType"], 10, 64); err != nil {
        return fmt.Errorf("invalid ProductType %q: %w", raw["ProductType"], err)
    }
    return nil
}

此方式优势明显：

强类型安全：解析失败立即返回具体错误（含字段名和原始值），便于调试；
零运行时panic：避免json.Unmarshal因类型不匹配触发不可控panic；
可扩展性强：支持空值处理、单位转换、精度校验等业务逻辑。

? 总结与最佳实践

始终检查原始JSON：使用curl或在线工具验证API返回的真实数据结构，勿凭经验假设数字字段必为数值类型；
优先使用string接收再转换：对不确定格式的数字字段（尤其含小数、千分位、科学计数法），先存为string，再按需ParseFloat/ParseInt；
禁用非必要JSON预处理：strings.Replace等字符串操作易引入bug，应优先通过UnmarshalJSON定制逻辑解决；
选用标准库或成熟JSON库：encoding/json已足够稳定；若追求性能，ffjson或easyjson需确保版本兼容性，避免与UnmarshalJSON自定义方法冲突；
添加单元测试：针对边界值（如"0.000"、"-12.34"、"1e-5"）编写测试用例，保障转换鲁棒性。