调试Fiber需分层定位：先查路由匹配（c.Path()与c.Route()）、再验中间件是否调用c.Next()、接着校验JSON序列化（避免nil指针panic）、然后检查fasthttp客户端超时配置，最后注意上下文缓冲区复用问题。
调试 Fiber 项目不是靠加 fmt.Println 硬打日志凑合，而是要分清「哪一层出问题」——是路由没匹配、中间件拦截了、JSON 序列化失败，还是底层 fasthttp 的连接异常。关键在于快速定位层级，避免在错误层反复试错。
看路由是否命中：用 c.Route() 和 c.Path() 对比
常见现象：请求发出去，浏览器卡住或返回 404，但代码里明明写了 app.Get("/api/user", ...)。
- 在 handler 开头加
log.Printf("path=%s, route=%+v", c.Path(), c.Route())，确认实际匹配到的路由对象是否为空 -
c.Path()是原始请求路径（如/api/user?id=1），c.Route()是注册时的模板（如/api/user）；若后者为nil，说明没匹配任何路由——检查是否漏了app.Use(...)中间件提前 return，或路径大小写/前缀不一致 - Fiber v2 默认区分大小写，
/API/user不会匹配/api/user；如需忽略，初始化时加配置：fiber.New(fiber.Config{CaseSensitive: false})
查中间件阻断：用 c.Next() 和 c.IsNext() 验证执行流
现象：接口一直不进业务 handler，或者日志只打印到某中间件就停了。
- 自定义中间件里必须显式调用
c.Next()才会继续向下执行；漏掉这句，后续所有 handler 都不会触发 - 在中间件末尾加
log.Printf("middleware done, is next? %t", c.IsNext())，如果返回false，说明前面某个中间件没调c.Next()或已return - 注意：Fiber 的
app.Use()注册的是「全局中间件」，而app.Get()后的 handler 是「末端处理器」；中间件里不能用c.SendString()后直接 return，否则会跳过后续逻辑，应改用c.Status(401).JSON(...)+return
抓响应体异常：用 c.Locals 传参 + c.JSON 前校验结构
现象：接口返回空响应、500 错误、或 JSON 字段缺失/类型错乱（比如该是 null 却变成空数组）。
- Fiber 的
c.JSON()会 panic 如果传入nil指针且未开启json.Marshal的omitempty控制；调试时先用c.Locals("debug_data", data)存值，再在中间件统一打印 - 避免直接
c.JSON(200, user)，改用：if err := json.Valid(dataBytes); err != nil { log.Printf("invalid json: %v", err) c.Status(500).SendString("JSON encode error") return } c.JSON(200, data) - 字段类型不一致（如前端要
"id": null，但结构体字段是*int且为nil）——确保 struct tag 正确：ID *int `json:"id,omitempty"`，否则nil指针会被序列化为0
连不上后端服务：用 fasthttp.HostClient 的超时和错误回调
现象：反向代理或内部 HTTP 调用卡死、超时、或返回 connection refused，但 Fiber 日志无报错。
- 别依赖
http.DefaultClient，它没有连接池控制；用fasthttp.HostClient并显式设超时：client := &fasthttp.HostClient{ Addr: "backend:8080", DialTimeout: 3 * time.Second, ReadTimeout: 5 * time.Second, MaxConnsPerHost: 100, } - 调用后检查
err是否为fasthttp.ErrTimeout或net.OpError，而不是只看 status code；fasthttp.Do(req, resp)成功不代表业务成功，还要看resp.StatusCode() - 若代理转发时路径没重写，后端收不到请求——必须配
proxy.Director，且修改路径要用req.URI().SetPath()，不能碰req.RequestURI()（它是只读副本）
真正容易被忽略的是上下文生命周期：所有从 c.Params()、c.Body()、c.Query() 拿到的字节切片都是复用缓冲区，离开 handler 就可能被覆盖。想存下来做异步处理，必须用 utils.CopyString 或手动 copy 分配新内存。
