本文解析 Go Web 服务中 json.Decoder.Decode() 返回空结构体的典型原因，重点说明 fmt.Printf 错误打印解码器本身、JSON 字段标签缺失、以及无符号整型（uint64/uint16）无法接收负数导致字段为零值等核心问题，并提供可运行的修复示例。
本文解析 go web 服务中 `json.decoder.decode()` 返回空结构体的典型原因，重点说明 `fmt.printf` 错误打印解码器本身、json 字段标签缺失、以及无符号整型（`uint64`/`uint16`）无法接收负数导致字段为零值等核心问题，并提供可运行的修复示例。
在 Go 编写 REST API 时，常遇到 json.NewDecoder(r.Body).Decode(&v) 后结构体字段仍为零值（如 Mac=""、RssiMax=0），控制台还输出类似 &{0xc820012b00 [...] {
json.NewDecoder(r.Body) 仅初始化一个解码器，它本身不读取或解析数据；fmt.Printf("Request Body: ", decoder) 实际打印的是解码器内部状态（含未导出字段），而非请求原始内容。正确做法是：先确保 r.Body 可读（注意多次读取需用 r.Body = ioutil.NopCloser(bytes.NewReader(buf)) 缓存），再调用 Decode()，最后打印目标结构体：
func InsertApData(w http.ResponseWriter, r *http.Request) {
// 关键：必须添加 json 标签，否则 Decode 无法映射字段
var apdata struct {
ID int `json:"id" db:"id"`
Mac string `json:"mac" db:"mac"`
RssiMax float64 `json:"rssi_max" db:"rssi_max"` // 改为 float64 以支持负数
RssiMin float64 `json:"rssi_min" db:"rssi_min"`
LocDefId uint64 `json:"loc_def_id" db:"loc_def_id"`
}
decoder := json.NewDecoder(r.Body)
if err := decoder.Decode(&apdata); err != nil {
http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
// ✅ 此时打印才是有效数据
fmt.Printf("Decoded data: %+v\n", apdata)
_, err := stmt.InsertApData.Exec(apdata.Mac, apdata.RssiMax, apdata.RssiMin, apdata.LocDefId)
if err != nil {
http.Error(w, "DB error: "+err.Error(), http.StatusInternalServerError)
return
}
}
关键修复点说明：
- JSON 标签缺失：原 ApData 结构体仅有 db:"..." 标签，json 包默认按字段名（首字母大写）匹配，但 JSON 键为小写（"mac"）。必须显式添加 json:"mac" 等标签。
- 类型不兼容：rssi_max 和 rssi_min 在 JSON 中是负浮点数（如 -73.50），而 uint64/uint16 是无符号整型，无法表示负值。解码时会静默失败并保留零值。应改用 float64（推荐）或 int64（若业务允许截断小数）。
-
调试技巧：避免直接 fmt.Printf("%v", decoder)；如需查看原始请求体，可用：
body, _ := io.ReadAll(r.Body) fmt.Printf("Raw body: %s\n", body) r.Body = io.NopCloser(bytes.NewReader(body)) // 恢复 Body 供 Decode 使用
总结：Go 的 JSON 解析失败往往源于标签不匹配或类型冲突，而非网络或框架问题。始终检查三要素：① 结构体字段是否导出（首字母大写）；② 是否正确定义 json:"key" 标签；③ JSON 值类型是否与 Go 字段类型兼容（尤其注意负数、浮点数与整型的转换）。
