如何用Golang Fiber框架创建RESTful API-Golang-PHP中文网

fiber 是 go 中最接近 express 风格的轻量级 web 框架，适合快速搭建 restful api；初始化用 app := fiber.new()，路由通过 app.get() 等方法注册，需显式处理参数解析、json 解码、错误返回和状态码设置。

如何用golang fiber框架创建restful api

直接说结论：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，和标准库行为完全一致，不额外做反射适配。

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

结构体字段必须首字母大写，否则 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() 返回空切片。

统一在 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}，避免日志泄露端口和路径