go语言的json.marshal函数仅能序列化导出（首字母大写）的结构体字段，未导出字段会被忽略；同时需合理使用struct tag指定json键名，否则默认使用大写驼峰名，影响api兼容性。

在Go中进行JSON序列化时，一个常见却容易被忽视的关键规则是：只有导出（exported）字段才能被encoding/json包访问和编码。所谓“导出字段”，即字段名以大写字母开头（如IMSI），而非小写（如imsi）。这是因为Go的反射机制无法访问非导出字段——而json.Marshal正是基于反射实现的。

在你的原始代码中：

type SpanInfo struct {
    imsi string          // ❌ 非导出字段 → JSON中被忽略
    network string       // ❌ 同上
    network_status string // ❌ 字段名本身也不符合Go命名规范（含下划线）
    signal_quality int    // ❌
    slot int              // ❌
    state string          // ❌
}

所有字段均为小写开头，属于包级私有字段，json.Marshal完全无法读取其值，因此输出为[{},{},{},{}]——即四个空对象。

✅ 正确做法是：

1. 将字段名改为导出形式（首字母大写）；
2. 通过json struct tag 显式指定小写/下划线风格的JSON键名，以保持API兼容性和可读性；
3. （可选）为字段添加omitempty等修饰符增强灵活性。

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

Oc Gateway Guardian

通过预检、监控诊断和证据捕获，防止长时间运行的 OpenClaw 网关不安全重启。

下载

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

完整使用示例：

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

func main() {
    spans := []SpanInfo{
        {
            IMSI:         "652020105829193",
            Network:      "20801",
            NetworkStatus: "Registered (Roaming)",
            SignalQuality: 17,
            Slot:         2,
            State:        "active",
        },
        {
            IMSI:         "652020105829194",
            Network:      "20801",
            NetworkStatus: "Registered (Roaming)",
            SignalQuality: 16,
            Slot:         3,
            State:        "standby",
        },
    }

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

    log.Printf("JSON output: %s", jsonInfo)
    // 输出示例：
    // [{"imsi":"652020105829193","network":"20801","network_status":"Registered (Roaming)","signal_quality":17,"slot":2,"state":"active"},...]
}

⚠️ 注意事项：

• 若字段可能为空值（如""、0、nil），可添加omitempty标签（如json:"imsi,omitempty"）实现在值为零值时省略该字段；
• json tag 中的键名区分大小写，且不支持表达式或变量，必须为静态字符串；
• 类型别名（如type GatewayInfo []SpanInfo）不影响序列化行为，只要元素类型正确即可；
• 始终检查json.Marshal返回的error，避免静默失败（示例中为简洁省略，生产环境务必处理）。

总结：Go的JSON序列化不是“自动魔法”，而是严格依赖导出性 + 结构体标签的显式约定。掌握这一原则，可避免90%以上的空JSON或字段丢失问题。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！