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完全无法读取其值，因此输出为[{},{},{},{}]——即四个空对象。
✅ 正确做法是：
立即学习“go语言免费学习笔记（深入）”；
- 将字段名改为导出形式（首字母大写）；
- 通过json struct tag 显式指定小写/下划线风格的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完整使用示例：
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或字段丢失问题。
