Buffalo 的 CORS 必须手动在每个路由 handler 中设置响应头且显式注册 OPTIONS 路由,因为 middleware.CORS 仅作用于 c.Render(),对 c.JSON() 等 API 响应无效;WebSocket 跨域需通过 upgrader.CheckOrigin 控制,中间件完全不生效。

Buffalo 的路由本身不支持跨域,必须手动在每个需要跨域的路由 handler 中设置响应头,且 OPTIONS 预检请求必须显式注册——中间件链对 API 和 WebSocket 完全无效。
为什么 app.Use(middleware.CORS) 对 API 路由没用
Buffalo 的 middleware.CORS 默认只在调用 c.Render() 时写入 header,而纯 API handler(如 c.JSON(200, data))会跳过渲染流程,header 根本不会被设置。你看到的“CORS 配置生效”只是错觉,浏览器控制台依然报 No 'Access-Control-Allow-Origin' header is present。
- 删掉所有
app.Use(middleware.CORS),它在 JSON API 场景下是冗余代码 - 不要试图用中间件统一处理,
WriteHeader()调用后 header 就锁死,后续Set()全部静默失败 - 如果你用了
pop.Transaction或csrf.Middleware,它们还会提前触发WriteHeader(),让 CORS 头彻底失效
app.Options() 必须显式注册,且路径要匹配
浏览器发跨域请求前必先发 OPTIONS 预检,Buffalo 不会自动 fallback 到任何 handler,你必须自己注册一条完全匹配的 app.Options() 路由。
- 用通配符
/api/*x匹配所有子路径,但别用/*x,否则管理接口(如/admin)也可能暴露 - handler 内只设 header +
return nil,不能调c.Render()或c.JSON(),否则触发两次WriteHeader() - 必须返回 200,Safari 对 204、404 等状态极其敏感,会导致后续请求被静默拦截
- 示例:
app.Options("/api/*x", func(c buffalo.Context) error { c.Response().Header().Set("Access-Control-Allow-Origin", "http://localhost:3000") c.Response().Header().Set("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS") c.Response().Header().Set("Access-Control-Allow-Headers", "Content-Type,Authorization") c.Response().Header().Set("Access-Control-Allow-Credentials", "true") return nil })
每个非-OPTIONS 路由 handler 开头必须手动设 header
GET/POST/PUT/DELETE 这些实际请求的响应头,和 OPTIONS 是两套逻辑,不能复用。你得在每个 handler 第一行就写 header,顺序错了就丢。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 必须在
c.JSON()、c.Render()、c.Error()之前调用c.Response().Header().Set() - 如果前端带
withCredentials: true,Access-Control-Allow-Origin不能是*,必须白名单校验:origin := c.Request().Header.Get("Origin") if origin == "https://your-frontend.com" || origin == "http://localhost:3000" { c.Response().Header().Set("Access-Control-Allow-Origin", origin) c.Response().Header().Set("Access-Control-Allow-Credentials", "true") } - 记得加
Vary: Origin,否则 CDN(如 Cloudflare)可能缓存错误的 origin 响应
WebSocket 路由跨域必须绕过中间件,用 upgrader.CheckOrigin
WebSocket 升级过程完全脱离 Buffalo 的中间件链,app.Use() 里写的任何 header 都进不了 Upgrade 响应。跨域控制只能靠 gorilla/websocket.Upgrader 的 CheckOrigin 回调和响应时机。
- 路由注册必须直连 handler:
app.GET("/ws", websocketHandler),不能包在中间件里 -
Upgrader初始化时必须设CheckOrigin,禁止用func(r *http.Request) bool { return true } - 示例:
var upgrader = websocket.Upgrader{ CheckOrigin: func(r *http.Request) bool { origin := r.Header.Get("Origin") return origin == "http://localhost:3000" || origin == "https://your-frontend.com" }, } - 升级调用必须用
upgrader.Upgrade(c.Response().Writer, c.Request(), nil),不能传c.Response()或调任何c.*Render()
最易被忽略的是:所有 header 设置都依赖执行顺序,一旦 c.JSON() 或 c.Render() 先执行,CORS 头就永远写不进去——而 Buffalo 不报错,只让你在浏览器控制台里干瞪眼。










