能跑通的 Fiber API 单元测试关键在于构造 *http.Request 并调用 app.Test(),需确保路由注册、路径匹配(含 group 前缀)、参数来源(Path/Query)正确,中间件需显式注册,Test() 同步执行不启服务。

直接用 app.Test() 就行,不用启服务、不占端口、不依赖网络,测完即走。
怎么写一个能跑通的 Fiber API 单元测试
关键不是构造 server,而是构造 *http.Request 并喂给 app.Test()。它内部会模拟 fasthttp 的请求处理流程,复用 Ctx 对象池,所以必须确保 handler 不逃逸 c 到 goroutine 或长期持有。
- 用
http.NewRequest()创建请求,注意 method、URL、body(如需)都要设对 - body 是 JSON 时,别忘加
Content-Type: application/jsonheader - 路由带参数(如
/user/:id)时,req.URL.Path必须填真实路径(如/user/123),Fiber 不会自动解析路径模板 - 调
app.Test(req)后,检查resp.StatusCode和io.ReadAll(resp.Body)内容即可
为什么 Test() 返回 404 而不是预期状态码
绝大多数是路由没注册成功或路径不匹配。Fiber 的 Test() 不走网络层,只走内部路由树匹配,所以问题一定出在测试代码本身,而不是端口或防火墙。
- 确认
setupRoutes(app)确实被调用了(比如在TestMain或每个 test 函数开头) - 检查
req.URL.Path是否和app.Get("/xxx")中的路径完全一致(注意前导 /、大小写、尾部斜杠) - 如果用了
app.Group(),确保 group 前缀已拼到req.URL.Path里(例如 group 是/api,handler 注册在/users,那请求路径得是/api/users) - 别用
http.DefaultClient去调app.Test()返回的 resp —— 它只是个 mock response,没有真正连接
如何测中间件或带参数解析的 handler
中间件和参数绑定(如 c.Params("id")、c.Query("page"))在 app.Test() 下完全可用,但要注意触发时机和数据来源。
-
c.Params("id")依赖req.URL.Path匹配路由模板,不是靠 query 或 body -
c.Query("sort")读的是 URL 查询参数,所以req.URL.RawQuery = "sort=desc" - 中间件执行顺序和正式运行时一致,但如果测试中漏了
app.Use(mw),它就不会生效 - 想验证中间件是否修改了
c.Locals或设置了 header,直接在 handler 里 assert,或从resp检查 header
最容易被忽略的是:Fiber 的 Test() 不会自动调 app.Listen(),也不触发 startup message 或 logger;但如果你在 handler 里用了 time.Sleep 或阻塞 IO,测试会卡住——因为它是同步执行的,没有真正的 event loop。


















