Fiber 框架推荐用 ctx.BodyParser() 绑定嵌套结构体，需正确声明 json tag；非标准表单字段用 ctx.FormValue()+json.Unmarshal()；轻量取值用 gjson.Get()；松散结构遍历需安全类型断言。
用 ctx.BodyParser() 直接绑定嵌套结构体
Go 的 Fiber 框架不推荐手动 json.Unmarshal() 解析请求体，ctx.BodyParser() 是更安全、更简洁的入口。它会自动处理空值、类型转换、字段缺失等边界情况，前提是你的 Go struct 字段标签写对了。
常见错误是字段没加 json tag 或大小写不匹配（如 JSON 里是 "user_profile"，struct 字段却叫 UserProfile 但没声明 json:"user_profile"），导致解析后字段为空。
- 所有嵌套字段必须显式声明
jsontag，即使名字一致（因为 Go 默认导出字段首字母大写，而 JSON 键通常是小写） - 可选字段加上
omitempty，避免反序列化时覆盖零值 - 嵌套数组用切片，嵌套对象用结构体指针（如
*Address）可规避 nil panic
示例：
type Address struct {
City string `json:"city"`
Zip string `json:"zip,omitempty"`
}
type UserRequest struct {
Name string `json:"name"`
Profile *Address `json:"user_profile"`
Tags []string `json:"tags,omitempty"`
}
app.Post("/user", func(c fiber.Ctx) error {
var req UserRequest
if err := c.BodyParser(&req); err != nil {
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"error": err.Error()})
}
// req.Profile.City 已可用
return c.SendStatus(fiber.StatusOK)
})
用 ctx.FormValue() + json.Unmarshal() 处理非标准嵌套字段
当前端把整个嵌套 JSON 当作一个表单字段发过来（比如字段名是 payload，值是字符串 {"a":1,"b":{"c":2}}），ctx.BodyParser() 就失效了——它只处理顶层 JSON body。
这时得先用 ctx.FormValue("payload") 拿到原始字符串，再手动 json.Unmarshal()。容易踩的坑是忘记检查返回的 err，或直接传未初始化的变量地址。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 务必用
json.RawMessage延迟解析深层嵌套部分（比如你只确定外层有id和data，但data内容结构多变） - 不要对
FormValue结果做strings.TrimSpace()后再解析——JSON 字符串本身可能含空格，且json.Unmarshal()能正确跳过空白 - 若
FormValue返回空字符串，json.Unmarshal()会报invalid character '错误，需提前判空
用 gjson.Get() 快速提取单个嵌套键值（无结构定义场景）
当你只是临时取一两个字段（比如日志里提 "meta.trace_id" 或告警里查 "labels.alertname"），又不想定义完整 struct，gjson 是最轻量的选择。它不解析整棵树，只按路径扫描，性能好、内存低。
注意 gjson.Get() 返回的是 gjson.Result，不是原始 Go 类型；要转成字符串/数字得调用 .String() 或 .Int() 等方法，否则直接打印是空或乱码。
- 路径支持点号和方括号，如
"items.0.name"、"data.headers.[0].key" - 若路径不存在，
.Exists()返回false，.String()返回空字符串——别依赖== ""判断缺失，要用.Exists() - 不要在循环里反复调用
gjson.Parse()同一段 JSON 字节，应提前 parse 一次复用gjson.Result
嵌套数组中按条件查找并提取字段的惯用写法
Fiber 本身不提供类似 JavaScript 的 find() 或 Python 的 next()，所以从 []map[string]interface{} 这类松散结构里找某个子项，得手写遍历。但直接用 for range 容易忽略类型断言失败导致 panic。
关键不是“怎么写循环”，而是“怎么安全地取值”。所有 map[string]interface{} 中的值都必须显式断言，不能假设是 string 或 float64（JSON 数字默认是 float64）。
- 用
if v, ok := item["id"].(float64); ok && int(v) == targetID判断数字字段 - 字符串字段用
if s, ok := item["name"].(string); ok && s == "xxx" - 嵌套 map 先断言
if m, ok := item["config"].(map[string]interface{}); ok，再进一层取 - 一旦断言失败，跳过当前项，不要
panic或返回错误——这是数据不规范，不是程序错误
真正复杂的需求（比如多级嵌套 + 多条件 + 提取关联字段），建议还是回归 struct + BodyParser，临时脚本才用 gjson 或手写遍历。
