如何在 Go 中正确使用 JSON 序列化结构体切片

心靈之曲 2026-01-18 00:00:00 次阅读

go 的 `json.marshal` 默认仅导出首字母大写的字段；若结构体字段为小写（未导出），序列化结果将为空对象，需通过标签和导出字段确保数据正确输出。

在 Go 中，JSON 编码（marshalling）遵循严格的可见性规则：只有导出字段（即首字母大写的字段）才能被 encoding/json 包访问并序列化。你定义的 SpanInfo 结构体中所有字段均为小写（如 imsi、network），属于未导出字段，因此 json.Marshal 无法读取其值，最终生成 [{},{},{},{}] 这样的空对象数组。

要解决此问题，需两步改造：

将字段名改为首字母大写，使其可导出；
配合 json 标签（tag）指定序列化后的键名，保持 JSON 字段命名风格（如 snake_case）不变。

修正后的结构体定义如

下：

type SpanInfo struct {
    IMSI         string `json:"imsi"`
    Network      string `json:"network"`
    NetworkStatus string `json:"network_status"`
    SignalQuality int    `json:"signal_quality"`
    Slot         int    `json:"slot"`
    State        string `json:"state"`
}

type GatewayInfo []SpanInfo

此时，即使 GatewayInfo 是类型别名（[]SpanInfo），只要其元素类型 SpanInfo 的字段已正确导出并标注，json.Marshal 即可完整序列化整个切片：

func getGatewayInfo(spans []SpanInfo) GatewayInfo {
    return GatewayInfo(spans)
}

// 使用示例
gatewayInfo := getGatewayInfo([]SpanInfo{
    {IMSI: "652025105829193", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 17, Slot: 2, State: "active"},
    {IMSI: "652025105829194", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 16, Slot: 3, State: "standby"},
})

data, err := json.Marshal(gatewayInfo)
if err != nil {
    log.Fatal(err)
}
log.Printf("JSON output: %s", data)
// 输出示例：
// [{"imsi":"652025105829193","network":"20801","network_status":"Registered (Roaming)","signal_quality":17,"slot":2,"state":"active"}, ...]

⚠️ 注意事项：