本文详解 Go Web 开发中常见问题：json.Decoder 未触发实际解析导致结构体为空、负数写入无符号整型引发数据截断，以及如何通过正确字段标签和类型匹配实现健壮的 REST API 请求解析。
本文详解 go web 开发中常见问题：`json.decoder` 未触发实际解析导致结构体为空、负数写入无符号整型引发数据截断，以及如何通过正确字段标签和类型匹配实现健壮的 rest api 请求解析。
在 Go 编写 REST API 时，若 http.Request.Body 解析后结构体字段全为零值（如 RssiMax: 0, RssiMin: 0），通常并非请求体为空，而是两个关键问题叠加所致：未正确读取 Body + JSON 字段与 Go 结构体类型/标签不匹配。
首先，fmt.Printf("Request Body : ", decoder) 输出的 &{0xc820012b00 [...]} 是 *json.Decoder 的内存地址和内部状态，并非实际请求内容——json.NewDecoder(r.Body) 仅初始化解码器，真正解析发生在 decoder.Decode(&apdata) 调用时。因此，调试应打印解析后的结构体，而非解码器本身：
err := decoder.Decode(&apdata)
if err != nil {
http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
fmt.Printf("Parsed apdata: %+v\n", apdata) // ✅ 此处才可看到真实值
其次，核心数据类型冲突必须修正：你的 JSON 提供的是负浮点数（"rssi_max": -73.50），但 Go 结构体定义为 uint64 和 uint16：
type ApData struct {
ID int `db:"id"`
Mac string `db:"mac"`
RssiMax uint64 `db:"rssi_max"` // ❌ 无法接收负数，强制转为 0
RssiMin uint16 `db:"rssi_min"` // ❌ 同上
LocDefId uint64 `db:"loc_def_id"`
}
这会导致 -73.50 和 -50.02 在解码时被静默转换为 0（Go 的无符号整型无法表示负值）。解决方案是使用有符号浮点或整型，并添加 json 标签明确映射：
type ApData struct {
ID int `db:"id" json:"-"` // 数据库用，JSON 不暴露
Mac string `json:"mac" db:"mac"` // ✅ 显式指定 JSON 键名
RssiMax float64 `json:"rssi_max" db:"rssi_max"` // ✅ 支持负浮点数
RssiMin float64 `json:"rssi_min" db:"rssi_min"` // ✅ 同上
LocDefId int64 `json:"loc_def_id" db:"loc_def_id"` // ✅ int64 更安全（JSON number → int64）
}
⚠️ 注意事项：
- r.Body 是一次性读取流，若之前已调用 r.ParseForm() 或手动读取过，r.Body 将为空，需用 r.Body = ioutil.NopCloser(bytes.NewReader(buf)) 重置（Go 1.16+ 推荐 io.TeeReader 或提前缓存）。
- 始终检查 decoder.Decode() 的返回错误，避免静默失败。
- 数据库操作前务必验证结构体字段有效性（如 Mac 非空、RssiMax
完整修复后的处理函数示例：
func InsertApData(w http.ResponseWriter, r *http.Request) {
// 设置响应头
w.Header().Set("Content-Type", "application/json")
// 解析 JSON
var apdata ApData
decoder := json.NewDecoder(r.Body)
if err := decoder.Decode(&apdata); err != nil {
http.Error(w, "JSON decode error: "+err.Error(), http.StatusBadRequest)
return
}
// 业务校验（示例）
if apdata.Mac == "" {
http.Error(w, "mac is required", http.StatusBadRequest)
return
}
// 执行数据库插入
result, err := stmt.InsertApData.Exec(apdata.Mac, apdata.RssiMax, apdata.RssiMin, apdata.LocDefId)
if err != nil {
http.Error(w, "DB insert failed: "+err.Error(), http.StatusInternalServerError)
return
}
// 返回成功响应
id, _ := result.LastInsertId()
json.NewEncoder(w).Encode(map[string]interface{}{
"success": true,
"id": id,
})
}
总结：Go 中 JSON 解析问题本质是类型契约不一致与流式 IO 特性理解偏差。牢记三点——Decode() 才触发解析、字段类型必须兼容 JSON 值、json 标签是映射桥梁。以此为基础，即可构建稳定可靠的 API 服务。
