Go 语言中正确解析 JSON 数组到结构体的完整指南-Golang-PHP中文网

Go 语言中正确解析 JSON 数组到结构体的完整指南

本文详解 Go 中 json.Unmarshal 解析嵌套 JSON 数组时常见的类型不匹配问题，重点解决因字段类型声明错误（如将字符串型数值误设为 int64/float64）导致的 panic，并提供安全、可维护的结构体定义与自定义反序列化方案。

本文详解 go 中 `json.unmarshal` 解析嵌套 json 数组时常见的类型不匹配问题，重点解决因字段类型声明错误（如将字符串型数值误设为 `int64`/`float64`）导致的 panic，并提供安全、可维护的结构体定义与自定义反序列化方案。

在 Go 开发中，对接外部金融行情 API（如 FXCM 的 ratesjson.fxcm.com）时，常需将返回的 JSON 数据反序列化为结构体。但若结构体字段类型与实际 JSON 值类型不一致，json.Unmarshal 会直接 panic，例如：

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

该错误的根本原因在于：JSON 中 "Bid"、"Ask"、"Spread" 和 "ProductType" 字段均为字符串（如 "1.45492"、"1"），而代码中却将其声明为 int64 或未做类型适配的数值类型。Go 的 encoding/json（及兼容库如 ffjson）严格校验类型，无法自动将 JSON 字符串转换为数字类型。

✅ 正确的基础结构体定义

最简健壮的做法是先按 JSON 实际格式声明字段类型——全部使用 string，避免早期解析失败：

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

type MsgRateQuoteJson struct {
    SymbolName   string `json:"Symbol"`
    SymbolBid    string `json:"Bid"`
    SymbolAsk    string `json:"Ask"`
    SymbolSpread string `json:"Spread"`
    SymbolPT     string `json:"ProductType"`
}

同时，修复原始代码中的关键错误：

❌ 错误：ffjson.Marshal(result) 将 JSON 字符串再次序列化（得到的是带转义的字节流）；
✅ 正确：直接 []byte(result) 转换即可；
❌ 错误：手动字符串替换 ",} 修复 JSON 是脆弱且易出错的（如末尾无逗号时失效）；
✅ 推荐：使用 json.Compact 或正则预处理，或改用容错性更强的解析库（如 gjson 处理脏数据）。

修正后的核心解析逻辑如下：

Expanso yaml-to-json

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

下载

// 清洗并提取有效 JSON（示例：移除多余逗号）
cleanJSON := strings.ReplaceAll(jsonString, ",}", "}")
jsonBytes := []byte(cleanJSON)

var msg MsgRatesArray
if err := ffjson.Unmarshal(jsonBytes, &msg); err != nil {
    log.Fatalf("JSON 解析失败: %v", err)
}
fmt.Printf("成功解析 %d 条行情\n", len(msg.RateQuote))

⚙️ 进阶：自动类型转换 —— 实现 `UnmarshalJSON`

若需在反序列化阶段直接获得 float64/int64 类型值（提升后续计算安全性），应为结构体实现 UnmarshalJSON 方法，利用 strconv 安全转换：

import "strconv"

type MsgRateQuoteJson struct {
    SymbolName   string  `json:"Symbol"`
    SymbolBid    float64 `json:"-"` // 禁用默认解析
    SymbolAsk    float64 `json:"-"`
    SymbolSpread float64 `json:"-"`
    SymbolPT     int64   `json:"-"`
}

func (m *MsgRateQuoteJson) UnmarshalJSON(data []byte) error {
    // 临时用 map[string]string 解析原始字符串
    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("解析 Bid 失败: %w", err)
    }
    if m.SymbolAsk, err = strconv.ParseFloat(raw["Ask"], 64); err != nil {
        return fmt.Errorf("解析 Ask 失败: %w", err)
    }
    if m.SymbolSpread, err = strconv.ParseFloat(raw["Spread"], 64); err != nil {
        return fmt.Errorf("解析 Spread 失败: %w", err)
    }
    if m.SymbolPT, err = strconv.ParseInt(raw["ProductType"], 10, 64); err != nil {
        return fmt.Errorf("解析 ProductType 失败: %w", err)
    }
    return nil
}