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生成空对象{}。
✅ 正确做法是：
立即学习“go语言免费学习笔记（深入）”；
- 将所有字段名首字母大写，使其导出；
- 通过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: "652020105829193", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 17, Slot: 2, State: "active"},
{IMSI: "652020105829194", 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":"652020105829193","network":"20801",...},{"imsi":"652020105829194",...}]
}⚠️ 注意事项：
- 若字段可能为空值（如""、0、nil），可追加omitempty标签（如json:"imsi,omitempty"）避免冗余键；
- 不要混淆json标签与字段名大小写——标签控制输出键名，首字母大小写控制是否可导出；
- 使用json.MarshalIndent可生成格式化JSON，便于调试；
- 始终检查json.Marshal返回的err，避免静默失败。
遵循导出规则是Go中JSON序列化的基础前提，也是与其他序列化格式（如XML、Gob）共通的设计约束。
