go中应直接将json解码到结构体而非map[string]interface{}，需确保字段导出（首字母大写）、显式添加json:"key"标签、类型严格匹配，错误必须检查，否则字段静默保持零值。
接收 JSON 时直接解码到结构体，别用 map[string]interface{} 中转
Go 的 json.Unmarshal 支持直接将字节流解码进预定义结构体，只要字段名、标签和 JSON 键匹配。中转成 map[string]interface{} 不仅多一次内存拷贝，还失去类型安全和编译期检查——多数情况下纯属徒劳。
- 确保结构体字段首字母大写（导出），否则
json包无法访问 - 用
json:"field_name"标签显式指定键名，尤其当 JSON 键含下划线或大小写不一致时（如user_id→UserID） - 嵌套对象、切片、指针字段都能原生支持，无需额外处理
- 如果 JSON 字段可能缺失，字段类型建议用指针（如
*string）或加omitempty标签控制序列化逻辑，但反序列化时不影响
json.Unmarshal 返回错误必须检查，空 payload 或字段类型错都会 panic 吗？
不会 panic，但会返回非 nil 错误。常见错误包括：JSON 语法错误（invalid character）、字段类型不匹配（如字符串往 int 里塞）、结构体字段不可导出。忽略错误会导致结构体字段保持零值，后续逻辑可能静默失败。
- 典型错误信息：
json: cannot unmarshal string into Go struct field X.Y of type int - 推荐写法：
if err := json.Unmarshal(body, &obj); err != nil { return err }，不要只打印日志就继续执行 - 若需容忍部分字段缺失或类型宽松，可先用
json.RawMessage延迟解析，或配合第三方库如go-json做容错解码
HTTP handler 中如何安全地绑定 JSON 到结构体
标准 http.Request 的 Body 是一次性读取流，读完即关闭。直接多次调用 io.ReadAll 会得到空数据，这是新手高频踩坑点。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 务必一次性读取：
body, err := io.ReadAll(r.Body)，然后关闭：r.Body.Close() - 别在中间件和 handler 里重复读
Body；如需复用，用http.MaxBytesReader限流，或提前把body存入context或自定义 request wrapper - 结构体定义建议加
Validate() error方法，在Unmarshal后校验业务约束（如邮箱格式、ID 非空），别全丢给数据库报错回传 - 对 public API，考虑用
encoding/json的DisallowUnknownFields()防止客户端传入非法字段
为什么有时候结构体字段没被赋值，明明 JSON 里有对应 key？
最常见原因是结构体字段缺少 json 标签，或标签值与 JSON key 不一致，又或者字段未导出（小写开头）。Go 的 json 包完全依赖反射+导出规则，不猜、不妥协。
- 检查字段是否小写：
name string永远不会被填充，必须写成Name string - 标签拼写错误：
json:"user_id"写成json:"user_id "（尾部空格）也会失败 - 嵌套结构体字段也要满足导出+标签规则，不能只在外层加
- 用
json:",string"标签可让数字字段接受字符串输入（如"123"→int），但需确认这是预期行为
字段没填上，大概率不是 JSON 解析器的问题，是结构体定义或标签没对齐。盯住那几行 struct 定义，比查文档更快。
