Go 中结构体嵌套 JSON 解码失败的常见原因及正确写法-Golang-PHP中文网

Go 的 json.Unmarshal 要求结构体字段必须是导出（首字母大写）且有对应 JSON 标签，否则字段不可见，导致解码后为 nil 且无错误提示。

go 的 `json.unmarshal` 要求结构体字段必须是导出（首字母大写）且有对应 json 标签，否则字段不可见，导致解码后为 nil 且无错误提示。

在 Go 中进行嵌套 JSON 解码时，若使用自定义结构体却始终得到 nil 值（且 error 为 nil），最常见的根本原因是：结构体字段未导出。

Go 的 encoding/json 包仅能访问并序列化/反序列化导出字段（即首字母大写的字段）。而问题中定义的结构体字段全为小写（如 missiles、others、you、gamestate、messagetype），属于非导出字段，json 包无法读写它们——因此解码过程“静默失败”：不报错，但所有字段保持零值（指针为 nil，切片为 nil，字符串为空），最终整个结构体看似“未填充”。

✅ 正确做法是：

所有需参与 JSON 编解码的字段必须首字母大写；
推荐显式添加 json 标签以明确映射关系，增强可维护性与健壮性（尤其当 JSON key 与 Go 字段名不一致时）；
指针字段（如 *Player）在解码时会被自动分配，但需确保其底层类型本身也满足导出要求。

以下是修正后的结构体示例：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

type Player struct {
    ID   string `json:"id"`
    X    float64 `json:"x"`
    Y    float64 `json:"y"`
}

type Missile struct {
    ID     string  `json:"id"`
    Target *Player `json:"target"`
}

type GameState struct {
    Missiles []*Missile `json:"missiles"`
    Others   []*Player  `json:"others"`
    You      *Player    `json:"you"`
}

type Message struct {
    GameState   *GameState `json:"gamestate"`
    MessageType string     `json:"messagetype"`
}

使用方式（完整解码示例）：

jsonData := `{
  "gamestate": {
    "missiles": [{"id":"m1","target":{"id":"p2","x":10.5,"y":20.3}}],
    "others": [{"id":"p1","x":0,"y":0}],
    "you": {"id":"p2","x":5,"y":5}
  },
  "messagetype": "stateupdate"
}`

var msg Message
if err := json.Unmarshal([]byte(jsonData), &msg); err != nil {
    log.Fatal("JSON decode failed:", err)
}
fmt.Printf("You: %+v\n", msg.GameState.You) // 正常输出 Player 结构体

⚠️ 注意事项：