Fiber 是 Go 中最接近 Express 风格的轻量级 Web 框架，适合快速搭建 RESTful API；初始化用 app := fiber.New()，路由通过 app.Get() 等方法注册，需显式处理参数解析、JSON 解码、错误返回和状态码设置。
直接说结论：Fiber 是 Go 里最接近 Express 风格的轻量级 Web 框架，适合快速搭建 RESTful API，但默认不带中间件、验证、数据库集成——这些都得自己配，否则容易在 ctx.JSON() 后漏掉错误处理或状态码。
怎么初始化一个 Fiber 服务并注册路由
Fiber 的入口极简，fiber.New() 返回 app 实例，所有路由用 app.Get()/app.Post() 等方法注册。注意：它不自动解析 URL 查询参数或 JSON body，必须显式调用 ctx.Query() 或 ctx.Body() + 手动解码。
-
app := fiber.New()就是全部启动逻辑，不需要http.ListenAndServe - GET 路由如
app.Get("/users", handler)，handler 函数签名必须是func(c *fiber.Ctx) error - 路径参数用冒号声明：
app.Get("/users/:id", handler)，取值用c.Params("id") - 别写
return nil就完事——Fiber 依赖返回error控制流程，return c.Status(200).JSON(...)是标准写法
为什么 c.JSON() 返回空对象或 500 错误
常见原因是传入了 nil 指针、未导出字段（首字母小写）、或结构体没加 JSON tag。Fiber 底层用 json.Marshal，和标准库行为完全一致，不额外做反射适配。
- 结构体字段必须首字母大写，否则
json.Marshal忽略：type User { Name string `json:"name"` } - 如果传的是
*User且指针为 nil，c.JSON(200, user)会返回null，不是错误，但前端常误判为失败 - 避免直接
c.JSON(200, result)，改用c.Status(200).JSON(result)显式设状态码，防止上层中间件覆盖 - 调试时加
if err := c.JSON(...); err != nil { log.Println(err) }，因为json.Marshal可能 panic（比如循环引用）
如何处理 POST JSON 请求并校验数据
Fiber 不内置表单或 JSON 校验，得靠 ctx.Body() 读原始字节，再用 json.Unmarshal 解析——这步最容易出错：body 只能读一次，多次调用 c.Body() 返回空切片。
立即学习“go语言免费学习笔记（深入）”；
- 统一在 handler 开头读一次：
body := c.Body(); var req CreateUserRequest; if err := json.Unmarshal(body, &req); err != nil { return c.Status(400).SendString("invalid JSON") } - 推荐用
github.com/go-playground/validator/v10做结构体校验，tag 如Name string `validate:"required,min=2"` - 别在中间件里提前
c.Body()，除非你确定后续 handler 不需要原始 body（比如日志中间件可以，但鉴权中间件可能要验签名） - 上传文件不能用
c.Body()，得用c.FormFile()+c.SaveFile()
为什么本地跑得通，部署到 Nginx 后 404 或 header 丢失
Fiber 默认信任所有请求头，不校验 X-Forwarded-For 或 X-Forwarded-Proto。Nginx 反向代理时若没配 proxy_set_header，c.IP() 返回 127.0.0.1，c.Protocol() 返回 http 即使实际是 HTTPS。
- Nginx 配置必须包含：
proxy_set_header X-Forwarded-For $remote_addr;和proxy_set_header X-Forwarded-Proto $scheme; - Fiber 需启用信任代理：
app := fiber.New(fiber.Config{ProxyHeader: fiber.HeaderXForwardedFor}) - 静态文件服务（
app.Static()）路径末尾不自动补斜杠，/assets和/assets/是两个不同路由，浏览器访问后者可能 404 - 生产环境务必关掉
fiber.Config{DisableStartupMessage: true}，避免日志泄露端口和路径
最常被跳过的点：Fiber 的 ctx.Next() 不像 Express 的 next()，它不自动继续中间件链——你得显式调用，否则中间件后所有路由都不执行；还有，app.Use() 注册的全局中间件对静态文件也生效，容易误拦截 .js 请求。
