Go语言中JSON反序列化失败的根本原因：结构体字段必须导出（首字母大写）-Golang-PHP中文网

Go语言中JSON反序列化失败的根本原因：结构体字段必须导出（首字母大写）

Go的encoding/json包仅能反序列化导出字段（即首字母大写的字段），小写字段会被静默忽略，导致解码后结构体字段全为零值且不报错。

go的`encoding/json`包仅能反序列化导出字段（即首字母大写的字段），小写字段会被静默忽略，导致解码后结构体字段全为零值且不报错。

在Go语言中，json.Unmarshal 依赖反射机制访问结构体字段，而Go的反射规则严格遵循包级可见性（exported/unexported）约定：只有首字母大写的字段才是导出字段，才能被外部包（如 encoding/json）读取和设置；以小写字母开头的字段属于包内私有，json 包完全无法访问——即使JSON数据格式正确、字段标签匹配、解析过程无错误，这些字段也始终维持零值（如 0、""、nil），造成“解码成功但内容为空”的典型假象。

以你提供的代码为例：

type Test struct {
  id   int    // ❌ 非导出字段：小写id，json包不可见
  text string // ❌ 非导出字段：小写text，json包不可见
}

尽管请求体 {"text": "Lorem ipsum dolor sit amet"} 完全合法，且 json.Unmarshal 返回 nil 错误，但 test.id 和 test.text 均未被赋值，最终输出为 {id:0 text:}。

✅ 正确做法是：同时满足两个条件

dmap-jsapi-skill

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

下载

字段名首字母大写（使其导出）；
通过 json:"..." 标签显式映射JSON键名（保持API命名风格，如小写 text）。

修正后的结构体如下：

type Test struct {
  ID   int    `json:"id"`   // 可选：若JSON中含"id"字段；当前示例无该字段，可省略或保留
  Text string `json:"text"` // ✅ 导出字段 + 精确标签映射
}

完整可运行的处理器示例（含健壮错误处理）：

func apiAddTestHandler(w http.ResponseWriter, r *http.Request) {
  // 读取请求体
  body, err := io.ReadAll(r.Body)
  if err != nil {
    http.Error(w, "Failed to read request body", http.StatusBadRequest)
    return
  }
  defer r.Body.Close()

  // 解析JSON
  var test Test
  if err := json.Unmarshal(body, &test); err != nil {
    http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
    return
  }

  // ✅ 此时 test.Text 已正确赋值
  fmt.Printf("Received text: %q\n", test.Text) // 输出: "Lorem ipsum dolor sit amet"

  // 后续业务逻辑...
  w.Header().Set("Content-Type", "application/json")
  json.NewEncoder(w).Encode(map[string]string{"status": "success", "received": test.Text})
}

⚠️ 注意事项：