Buffalo默认不自动处理OPTIONS预检请求,必须显式注册app.Options()路由并返回200/204;CORS响应头需在handler首行手动设置,且凭证实例禁止使用通配符Origin。

Buffalo 默认不自动处理 OPTIONS 预检请求
Buffalo 不像 Gin 或 Echo 那样默认为 CORS 预检返回 204 或 200。如果你的前端发出了带 Content-Type: application/json 或自定义 header 的请求,浏览器会先发 OPTIONS,而 Buffalo 的路由层若没显式匹配该方法,就会直接 404 或 fallback 到 405(Method Not Allowed)。
手动注册 OPTIONS 路由是最可靠的方式
不要依赖中间件“自动拦截”,Buffalo 的 middleware.SecureHeaders 或第三方 CORS 中间件(如 github.com/rs/cors)通常只处理响应头,不接管 OPTIONS 请求分发。必须在路由表里明确定义:
- 在
app.go的app.Routes()里用app.Options()显式注册 - 路径需与目标路由完全一致(包括参数占位符),否则预检失败
- handler 只需返回
c.Render(204, r.NoContent()),无需 body
示例:
app.Options("/api/users/{id}", func(c buffalo.Context) error {
return c.Render(204, r.NoContent())
})
app.Put("/api/users/{id}", UserUpdateHandler)
用 middleware 拦截所有 OPTIONS 是可行但有风险的
如果你路由多、路径动态(比如含 UUID 或嵌套路由),逐个写 app.Options() 太繁琐。可改用全局中间件提前响应,但要注意:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 必须放在所有路由注册之前(
app.Use()要早于app.Routes()) - 中间件里不能调用
c.Next(),否则仍会走到后续路由逻辑 - 要检查
c.Request().Method == "OPTIONS",且只对 API 路径生效(避免干扰静态资源) - 务必设置
Access-Control-Allow-Methods等头,否则浏览器可能拒绝后续请求
简版中间件示例:
app.Use(func(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
if c.Request().Method == "OPTIONS" && strings.HasPrefix(c.Request().URL.Path, "/api/") {
c.Response().Header().Set("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,PATCH,OPTIONS")
c.Response().Header().Set("Access-Control-Allow-Headers", "Content-Type,Authorization")
c.Response().Header().Set("Access-Control-Allow-Origin", "*")
return c.Render(204, r.NoContent())
}
return next(c)
}
})
CORS 插件 buffalo-plugins/cors 并不接管 OPTIONS 分发
社区插件 github.com/gobuffalo/buffalo-plugins/cors 仅负责注入响应头,它不会注册任何路由、也不会短路 OPTIONS 请求。它的作用等价于上面中间件里那几行 Header().Set(),但不包含 Render(204) 逻辑。所以即使启用了它,你依然得自己处理 OPTIONS 响应,否则预检仍失败。
最容易被忽略的是:CORS 头设置和 OPTIONS 响应是两件事——前者告诉浏览器“允许什么”,后者告诉浏览器“我准备好了”。缺一不可。










