Go 1.9.4解析请求JSON转HTML失败，解码报错求助

你遇到的这个问题在Go服务端处理JSON请求时挺常见的——虽然客户端生成的JSON是有效的，但解码失败往往出在服务端的结构体映射、请求头或者版本兼容这些细节上。结合Go 1.9.4的特性，我给你整理几个排查方向和解决方法：

• 检查结构体字段的JSON标签是否匹配
  Go的encoding/json包要求结构体字段必须是导出的（首字母大写），并且需要通过json:"字段名"标签和JSON中的键名一一对应。比如客户端传的JSON是{"userName":"张三","userAge":25}，你的结构体就得这么写：

  type UserData struct {
      UserName string `json:"userName"`
      UserAge  int    `json:"userAge"`
  }
  

  如果标签名写错、漏写，或者大小写不匹配，解码时对应的字段就会是零值，甚至直接报错。

• 确认请求的Content-Type头是否正确
  哪怕客户端用JSON.stringify生成了正确的JSON，如果请求头的Content-Type不是application/json，Go的json.NewDecoder(r.Body)可能无法正确识别请求体格式。你可以先在服务端把请求体读出来打印看看，确认收到的内容是不是预期的JSON：

  body, err := ioutil.ReadAll(r.Body)
  if err != nil {
      http.Error(w, "Failed to read request body", http.StatusBadRequest)
      return
  }
  defer r.Body.Close()
  fmt.Printf("Received JSON: %s\n", string(body)) // 查看实际收到的内容
  
  // 再尝试解码
  var data UserData
  if err := json.Unmarshal(body, &data); err != nil {
      fmt.Printf("Decode error: %v\n", err)
      http.Error(w, "Failed to decode JSON", http.StatusBadRequest)
      return
  }
  

• 验证JSON是否存在Go 1.9.4不兼容的语法
  Go 1.9.4是比较老的版本（2018年发布），它的encoding/json对一些非标准JSON语法的容错性不如新版本。比如有些客户端可能生成带尾随逗号的JSON（比如{"name":"张三",}），这不符合JSON标准，Go 1.9.4的解码器会直接报错。你可以用json.Valid()函数验证客户端的JSON字符串：

  clientJSON := `{"userName":"张三","userAge":25}` // 替换成客户端生成的JSON
  if !json.Valid([]byte(clientJSON)) {
      fmt.Println("JSON格式不合法！")
  } else {
      fmt.Println("JSON格式合法")
  }
  

• 处理null值或嵌套结构的类型匹配问题
  如果JSON里有null值，而你的Go结构体字段是值类型（比如int、string），解码会失败。这时候可以改用指针类型来接受null：

  type UserData struct {
      UserName *string `json:"userName"` // 当JSON是null时，解码后为nil
      UserAge  int     `json:"userAge,omitempty"` // 忽略null值，保留零值0
  }
  

  如果JSON里有嵌套对象或数组，你的结构体也要对应嵌套定义，比如JSON里有{"address":{"street":"XX路","city":"XX市"}}，那结构体就得定义嵌套的Address类型。

按照这些步骤排查，应该能找到解码失败的原因。

内容的提问来源于stack exchange，提问作者John Balvin Arias