buffalo 框架本身不引发 goroutine 泄漏，问题根源在于用户代码中 handler、中间件、websocket、数据库操作等未正确管理 goroutine 生命周期，需通过 runtime.numgoroutine() 趋势判断、pprof/goroutine?debug=2 定位卡点，并在测试中规范使用 goleak.verifytestmain 和资源清理。
Buffalo 框架本身不引入 goroutine 泄漏，但项目里用的 HTTP handler、中间件、后台任务、数据库连接池、WebSocket 长连接等，都可能在 Buffalo 的生命周期中埋下泄漏点。排查核心不是“Buffalo 有没有问题”，而是“你写的代码有没有让 goroutine 卡住不退出”。
怎么用 runtime.NumGoroutine() 快速确认泄漏存在
Buffalo 启动后 goroutine 数通常在 50–120 之间（含 pprof、log、db 连接池初始化等），关键看趋势：
- 单次请求前后打点：在
App.ServeHTTP前后加log.Printf("goroutines: %d", runtime.NumGoroutine())，若 handler 返回后数字没回落，大概率有泄漏 - 压测后等待 30 秒再查，总数仍比空闲态高 30+，基本可定性
- Buffalo 的
buffalo.New()默认启用net/http/pprof，但需确保没被中间件拦截或路由覆盖；若没开，手动注册：http.Handle("/debug/pprof/", http.HandlerFunc(pprof.Index))
为什么 /debug/pprof/goroutine?debug=2 是线上唯一有效入口
Buffalo 服务跑起来后，直接 curl http://localhost:3000/debug/pprof/goroutine?debug=2（端口以实际为准）——注意必须带 ?debug=2，否则只返回统计摘要，看不出卡在哪：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 重点关注状态为
chan receive（尤其(nil chan)）、select（无default且所有 case 不可达）、semacquire（sync.Mutex没 unlock 或sync.WaitGroup忘记Done()） - 大量 goroutine 卡在
github.com/gobuffalo/buffalo/render.(*Renderer).Render或net/http.serverHandler.ServeHTTP通常不是 Buffalo 问题，而是你 render 里调了阻塞 IO（如未设 timeout 的http.Client.Do） - Buffalo 的 WebSocket handler（
websocket.Handler）若没显式 closeconn或监听ctx.Done()，会永久挂起
goleak.VerifyNone(t) 在 Buffalo 测试里总失效？检查这三点
Buffalo 的测试默认用 buffalo.Test 启 server，容易干扰 goleak 判定：
- 别在每个
TestXxx里写defer goleak.VerifyNone(t)，改用func TestMain(m *testing.M) { goleak.VerifyTestMain(m) }，它能包裹整个生命周期 - Buffalo 测试中启动的
http.Server、time.Ticker（比如健康检查轮询）、database/sql连接池后台 goroutine 都要显式清理：测试前goleak.IgnoreCurrent()，或用goleak.IgnoreTopFunction("github.com/gobuffalo/pop/v6.Open")忽略已知库行为 - 确保测试逻辑真正结束：比如 WebSocket 测试里，不能只发消息就 return，得
conn.Close()后再等time.Sleep(10ms)，否则 goroutine 可能还在收包队列里
Buffalo 项目里最常漏掉的泄漏点
这些地方不报错、不 panic，但一压测就 goroutine 爬升：
-
buffalo.MiddlewareFunc里启了go func() { ... }()却没绑定ctx，handler 返回后它还在等 channel 或 timer - 用
time.AfterFunc注册回调，但没在App.Cleanup里调Stop()（Buffalo 1.24+ 支持App.Cleanup(func(){})） - 数据库查询用了
tx.WithContext(ctx)，但 ctx 来自buffalo.Context.Request().Context()，而 handler 返回后这个 ctx 已 cancel —— 若 tx 内部还起了 goroutine 并试图写回未关闭的 channel，就会卡住 - 自定义
render.JSON时传了闭包，闭包捕获了大 struct 或*sql.DB，该闭包又被 Buffalo 的模板缓存或全局 map 持有
真正难查的泄漏，往往藏在闭包捕获的变量逃逸到堆后，又被 Buffalo 的中间件链或渲染器长期持有——这时 runtime.NumGoroutine() 看着正常，但 heap 差分会暴露 bytes.makeSlice 持续上涨。
