Go语言中JSON序列化失败：结构体字段未导出导致空对象问题

聖光之護 2026-01-18 00:00:00 次阅读

go语言中使用json.marshal序列化结构体时，若字段名首字母小写（未导出），则无法被json包访问，导致生成空对象（如{}）；必须将字段改为大写首字母并配合json标签才能正确序列化。

在Go中，JSON编码器（encoding/json）仅能访问导出字段（即首字母大写的字段）。这是Go语言的可见性规则决定的：小写开头的字段属于包内私有，外部包（包括标准库中的json）无法反射读取其值，因此序列化结果中对应字段被忽略，最终生成空JSON对象{}。

例如，原始代码中定义的SpanInfo结构体：

type SpanInfo struct {
    imsi string        // ❌ 小写 → 未导出 → JSON中不可见
    network string      // ❌ 同上
    network_status string
    signal_quality int
    slot int
    state string
}

尽管运行时gatewayInfo切片包含有效数据（日志中可见Polling content: [{...} {...}]），但json.Marshal因无法访问任何字段，只能为每个SpanInfo生成空对象{}。

✅ 正确做法是：

将所有字段名首字母大写，使其导出；
通过json标签指定JSON键名（保持小写风格，符合API惯例）；
可选：为整数/布尔字段添加omitempty等修饰符提升健壮性。

修正后的结构体定义如下：

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 // 切片类型无需修改，仍可直接Marshal

完整使用示例：

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

func main() {
    spans := []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: "active"},
    }

    gatewayInfo := getGatewayInfo(spans)
    jsonInfo, err := json.Marshal(gatewayInfo)
    if err != nil {
        log.Fatal("JSON marshal error:", err)
    }

    log.Printf("jsonInfo: %s", jsonInfo)
    // 输出: [{"imsi":"652025105829193","network":"20801",...},{"imsi":"652025105829194",...}]
}

⚠️ 注意事