安装Fiber扩展需手动go get对应模块并显式注册:JWT用go get github.com/gofiber/jwt/v3后app.Use(jwt.New());Swagger需swag工具链加http-swagger并路由挂载;CORS用go get github.com/gofiber/fiber/v2/middleware/cors后app.Use(cors.New())。

怎么安装 Fiber 扩展插件(比如 JWT、Swagger、CORS)
直接用 go get 安装对应模块,不依赖 fiber.New() 的任何自动加载机制——Fiber 没有“插件市场”或 app.Install() 这类语法,所有扩展都是独立包,按需导入、手动注册。
常见错误是以为装完就自动生效,结果 CORS 403、JWT 解析失败、Swagger 页面空白,其实只是漏了 import 或没调 app.Use() / app.Get()。
-
go get github.com/gofiber/fiber/v2是核心,必须先装 - JWT:运行
go get github.com/gofiber/jwt/v3,然后import "github.com/gofiber/jwt/v3",再用jwt.New(...)构造中间件传给app.Use() - Swagger:运行
go get github.com/swaggo/swag/cmd/swag(生成工具) +go get github.com/swaggo/http-swagger(服务端),再在main.go里加app.Get("/swagger/*", swagger.Handler(...)) - CORS:运行
go get github.com/gofiber/fiber/v2/middleware/cors,然后app.Use(cors.New())——注意它默认放行所有源,生产环境必须配cors.Config{AllowOrigins: "https://myapp.com"}
中间件添加方法:Use() vs Group().Use() vs 路由内嵌
app.Use() 是最常用入口,但它只做前缀匹配和全方法覆盖,不是“某个路由专属中间件”。真正控制作用域靠的是组合方式。
容易踩的坑:把 app.Use("/api/users", auth) 当成“仅对 /api/users 生效”,实际它会命中 /api/users/delete、/api/users/123/profile,甚至 /api/usersxxx(只要前缀是 /api/users 且后接 / 或路径结束)。
- 全局中间件:
app.Use(logger, recover),无前缀,所有请求都过 - 前缀级中间件:
app.Use("/api", cors.New(), jwt.New(...)),匹配/api、/api/v1、/api/foo/bar,但不匹配/apis - 路由分组专用:
api := app.Group("/api")→api.Use(auth)→api.Get("/users", h),这样auth只对/api/*下显式注册的子路由生效,更干净 - 单路由叠加:
admin.Get("/delete", ipWhitelist, adminAuth, handler),多个中间件按顺序执行,适合某接口额外加白名单等场景
中间件函数签名和 c.Next() 必须写对
Fiber 中间件和路由处理器共用同一签名:func(*fiber.Ctx) error。这不是约定,是强制类型;传错会编译报错或 panic。
最常被忽略的细节:不调 c.Next() 就等于中断整个链,后续所有中间件和最终 handler 都不会执行——包括你刚写的 app.Get("/data", ...)。
- 想记录日志并放行:必须写
return c.Next(),不能只写c.Next()(会继续往下跑,可能触发 panic) - 想拦截并返回错误:用
return c.Status(401).JSON(fiber.Map{"error": "unauthorized"}),别再调c.Next() - 想提前返回但又不终止链(比如注入 header):可以不 return,但结尾仍要
c.Next(),例如c.Set("X-Processed", "true"); return c.Next() - 所有中间件里禁止在
c.Next()后再写响应体,否则 panic:body already written
为什么中间件顺序错了会导致鉴权失效或日志缺失
中间件执行顺序 = 代码注册顺序,而且是严格串行。Fiber 不做拓扑排序或依赖解析,谁先注册谁先跑。
典型反例:把日志中间件放在鉴权之后,那未通过鉴权的非法请求就不会进日志;把限流器放鉴权前面,攻击者可能绕过 token 校验直接打爆限流计数器。
- 推荐顺序:recover → logger → rateLimit → jwt/auth → 其他业务中间件 → 路由 handler
- Group 分组内顺序同样重要:
api.Use(logging, auth, rbac)表示每个请求依次进 logging → auth → rbac → handler - 如果某中间件 panic(比如 JWT 解析空 token),
recover必须在它前面,否则整个服务崩掉 - 别把
app.Use("/health", healthCheck)这种监控探针放太后面,它应该跳过所有耗时中间件,最好单独用app.Get("/health", ...)
Use 当成“路由装饰器”,结果发现 /api/users/ 和 /api/users 被当成两个路径,而中间件却同时生效了。


















