Buffalo不是轻量级API网关，而是全栈Web框架，需改造为可控HTTP应用容器：删前端资源、禁自动迁移、设超时Server、去HTML路由、管DB连接池。
Buffalo 不是传统意义上的“接口暴露层”，它本身是一个全栈式 Web 框架（含路由、模板、DB 迁移、热重载等），不是轻量级的 API 网关或反向代理。直接把它当 RESTful 接口暴露层用，容易在生产环境踩坑——比如它默认启动的是开发模式服务器、自带会话和前端资源服务、对健康检查/超时/负载均衡支持弱。
真正可行的做法，是把它当作 带数据库集成能力的 REST API 应用容器，再通过标准方式暴露出去。下面说清楚怎么做、为什么、以及最容易被忽略的点。
buffalo new --api 生成的项目默认不适用于生产暴露
执行 buffalo new myapi --api 后，项目仍包含大量开发向依赖（如 webpack、pop/soda CLI、hot-reload 中间件），且 buffalo dev 启动的服务器没有设置 ReadTimeout / WriteTimeout，也不监听 $PORT（Heroku/K8s 要求）。直接部署到云平台常出现：请求挂起、连接复用异常、健康检查失败。
- 必须删掉
assets/和templates/目录（除非你真需要 SSR） - 禁用
Pop的自动迁移钩子（app.Serve()里默认调用soda migrate up），改用独立的buffalo pop migrate up步骤 - 把
http.ListenAndServe替换为带超时控制的http.Server实例（见下节）
替换默认 server 启动方式，适配容器化部署
buffalo 的 main.go 默认调用 app.Serve()，底层用的是无配置的 http.ListenAndServe。生产环境必须接管 http.Server 实例，否则无法设置关键参数。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
修改 main.go 中的启动逻辑：
srv := &http.Server{
Addr: ":" + os.Getenv("PORT"),
Handler: app,
ReadTimeout: 15 * time.Second,
WriteTimeout: 15 * time.Second,
IdleTimeout: 60 * time.Second,
}
log.Fatal(srv.ListenAndServe())
-
PORT必须从环境变量读取（Heroku、Fly.io、K8s Service 都依赖这个） - 不要用
buffalo dev上生产；构建时用go build -o bin/myapi .，运行时只执行二进制文件 - 若用 Docker，
Dockerfile中需显式EXPOSE $PORT并确保PORT=8080（或其他一致值）
路由注册与中间件需显式剥离前端逻辑
buffalo 的 app.go 默认注册了 / 的 HTML 响应（HomeHandler），即使加了 --api 参数，该路由仍存在。API 层不该返回 HTML，否则 Nginx 或 ALB 会误判健康状态。
- 删掉
app.GET("/", HomeHandler)这一行（位于app.go） - 所有 API 路由应统一加前缀，如
app.Group("/api/v1", func(a buffalo.App) {...})，避免和未来可能的管理端点冲突 - 若需 CORS，别用
buffalo-cors插件（已过时），改用标准net/http中间件：func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Access-Control-Allow-Origin", "*") }
数据库连接池和连接泄漏是上线后最常崩的点
buffalo 默认使用 pop ORM，其连接池配置藏在 database.yml 的 max_open_connections 和 max_idle_connections 字段里。但很多人忽略：每次 c.DB() 获取的连接不会自动 Close，必须靠事务 tx.Commit() 或 tx.Rollback() 触发释放。
- 永远不要在 handler 里直接用
models.DB.Create(...)；必须用tx, err := models.DB.Transaction()+defer tx.Rollback() -
max_open_connections建议设为2 * (CPU 核数)，而非默认的0（无限） - 上线前跑一次
buffalo pop fix，确保 migration 文件名时间戳正确，否则 K8s 启动多个副本时会抢锁失败
真正要让 Buffalo 在 Golang 架构里稳住 RESTful 接口角色，核心不是“怎么写业务逻辑”，而是“怎么把它从一个开发框架降级成一个可控的 HTTP 应用容器”——删冗余、管连接、控超时、去 HTML。这些动作不难，但漏掉任意一项，都可能在流量突增时表现为 504 或连接耗尽。
