Buffalo的buffalo.Handler须通过app.NewContext(w, r)封装为http.HandlerFunc，不可强制类型断言或手动构造Context；需显式调用c.Next()并检查c.Response().Written()避免重复写头。
Buffalo 路由如何包装成 http.HandlerFunc
Buffalo 的 buffalo.Handler 不能直接当 http.HandlerFunc 用，但可以安全封装。核心是把 c buffalo.Context 和 next 调用链转成标准 http.ResponseWriter + *http.Request 接口。
常见错误是强行类型断言或忽略上下文生命周期——比如写 http.HandlerFunc(myBuffaloHandler)，编译失败；或手动构造 buffalo.Context 导致 panic，因为 Context 依赖 app 实例和中间件栈初始化状态。
- 必须通过
app.NewContext(w, r)创建合法的buffalo.Context，不能 new 或 &struct{} 初始化 - 封装函数里要显式调用
c.Next()，否则下游 handler 不执行；返回前需检查c.Response().Written()避免重复写头 - 若原 Buffalo handler 用了
c.Render()，封装后仍可正常工作；但若用了c.Redirect()或c.Error()，它们内部已设状态码，http.HandlerFunc层无需再干预
示例封装：
func BuffaloToHTTP(app *buffalo.App, h buffalo.Handler) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
c := app.NewContext(w, r)
err := h(c)
if err != nil {
// 触发全局错误中间件，或自行处理
app.ErrorHandler.ServeHTTP(w, r)
return
}
// 确保响应已写出，避免空响应
if !c.Response().Written() {
w.WriteHeader(http.StatusOK)
}
}
}
gorilla/mux 怎么挂载 Buffalo handler
Buffalo 默认用 net/http 标准路由，但企业级场景需要动态路由能力（如 etcd 加载、灰度路径），这时得换 gorilla/mux 并把 Buffalo handler 当作普通 http.Handler 注册。
关键点不是“替换路由器”，而是“复用 Buffalo 的中间件和 Context 生态”。别删掉 app.Middleware 链，而是让 gorilla/mux 把请求先交给 Buffalo 的中间件栈处理，再进 action。
- 在
actions/app.go初始化阶段，调用app.Use()注册所有全局中间件（日志、CORS、版本校验等） - 创建
gorilla/mux.Router，对每个业务路径调用r.Handle(path, BuffaloToHTTP(app, handler)).Methods("GET") - 不要把
app.Serve()和http.ListenAndServe()混用：只用http.ListenAndServe(":8080", mux)，让 mux 统一调度 - 注意
app.Routes()返回的是只读结构，修改它会 panic；你要绕过它，而不是覆盖它
为什么不能直接赋值 app.Router = muxRouter
Buffalo 的 app.Router 字段是私有且不可写入的，源码中它是未导出字段，反射也无法安全赋值。试图用 app.Router = muxRouter 会导致编译失败或运行时 panic。
更隐蔽的问题是：即使你 hack 成功，Buffalo 的中间件注册（app.Use()）、静态文件服务（middleware.Static）、模板渲染（c.Render()）都强依赖内部 app.router 实现细节，外部替换后这些功能大概率失效。
- Buffalo 的
app.Serve()内部硬编码调用app.router.ServeHTTP()，不接受接口注入 -
app.Group()和app.Resource()生成的路由规则，不会自动同步到 gorilla/mux 中 - 所有
app.GET("/health", ...)这类声明式路由，依然走 Buffalo 原生 router，和你挂的 mux 完全无关——容易造成路由分裂，一部分走 mux，一部分走 Buffalo，默认行为混乱
对接后怎么保持中间件顺序正确
Buffalo 中间件顺序决定数据可用性，比如 pop.Transaction 必须在自定义中间件之前执行，否则 c.Value("tx") 为空。换成 gorilla/mux 后，这个顺序要手动重建。
你不能再依赖 app.Use() 的隐式链式注册，而要把整个中间件栈显式拼成一个 http.Handler 链，再传给 mux。
- 用
buffalo.MiddlewareStack提取当前 app 的中间件列表：stack := app.Middleware.Stack() - 从栈底到栈顶依次 wrap：最外层是日志，中间是事务，最内层才是你的
BuffaloToHTTP(app, h) - 别漏掉
middleware.ParameterParser，它负责解析 form/json body，缺失会导致c.Param()和c.Bind()失效 - 如果用了
app.Options.MaxBodySize，它底层靠middleware.ParameterParser实现，也要确保它在链中
真正麻烦的不是技术实现，而是每次 Buffalo 升级都可能调整中间件默认顺序——你得持续对齐源码里的 DefaultMiddleware 列表。
