OPTIONS请求总404是因为Iris不自动注册该方法,需显式用app.Options()或app.Any()注册;CORS中间件必须挂载到对应Party而非根应用,且OPTIONS处理后须短路终止流程。

为什么 OPTIONS 请求总是 404?
Iris 不会自动注册或捕获 OPTIONS 路由,哪怕你写了 Cors 中间件并调用了 app.Use()。中间件只对已注册的路由方法生效,而预检请求是独立的 HTTP 方法,若没显式注册,Iris 就直接返回 404——根本不会进入任何中间件逻辑。
常见错误写法:app.Use(corsMiddleware) 后没补任何 OPTIONS 路由 → 前端控制台报 Response to preflight request doesn't pass access control check。
- 必须用
app.Options()或app.Any()显式注册路径,比如app.Options("/api/*path", corsHandler) - 若 API 分组在
api := app.Party("/api")下,则需在该分组上调用api.Options("*", corsHandler),不能只在根级注册 -
app.Any()更省事:它能匹配所有方法(含 OPTIONS),适合全局兜底,例如app.Any("/*path", corsHandler)
怎么写一个安全可用的 CORS 中间件?
硬编码 Access-Control-Allow-Origin: "*" 看似简单,但一旦前端启用 credentials: 'include'(比如带 cookie 或 Authorization 头),浏览器就会拒绝响应——因为 Allow-Credentials: true 和 Allow-Origin: "*" 是互斥的。
正确做法是动态读取请求头中的 Origin,再比对白名单:
- 用
ctx.Request().Header.Get("Origin")获取原始值,空值或非法值应返回403,而非默认放行 - 白名单要严格匹配协议、端口、末尾斜杠,例如
"https://example.com"≠"https://example.com/" - 只对白名单内的源设置
Access-Control-Allow-Origin和Access-Control-Allow-Credentials: "true" -
Access-Control-Allow-Methods和Access-Control-Allow-Headers只应在 OPTIONS 响应中设置,不要在 GET/POST 中重复写
如何避免中间件和 MVC 路由不生效?
Iris 的 MVC 模式(如 mvc.Configure(api, ...))不继承根应用的中间件链。你在 app.Use() 注册的 CORS 中间件,对控制器路由完全无效。
必须把 CORS 显式挂载到 MVC 所绑定的 Party 实例上:
- 错误写法:
app.Use(cors.New())→ 对api.Party("/user")内的控制器无影响 - 正确写法:
api.Use(cors.New().Handler()),其中api := app.Party("/api") - 若用官方
iris.CORS,可传入配置:iris.CORS(iris.CORSConfig{AllowOrigins: []string{"https://myapp.com"}}) - 绝对不要在控制器里手动调用
ctx.ResponseWriter().Header().Set()设置 CORS 头——会覆盖中间件逻辑,尤其破坏 OPTIONS 响应
OPTIONS 处理必须短路,否则会出问题
OPTIONS 请求处理完后必须立即终止流程,否则后续中间件或 handler 可能误读空 body、触发鉴权失败,甚至 panic。
- 在中间件中判断
ctx.Method() == "OPTIONS"后,务必调用ctx.StatusCode(204)并return - 不要写
ctx.Next(),那会让请求继续往下走,可能执行 JWT 验证、数据库查询等无意义操作 - 如果用了
app.Any(),也要确保 handler 内部对 OPTIONS 做短路,而不是靠框架“自动跳过” - 调试时用
curl -X OPTIONS -H "Origin: https://myapp.com" -I http://localhost:8080/api/user检查响应头是否完整
实际部署时最容易被忽略的是:白名单校验逻辑必须覆盖所有可能的 Origin 格式(含端口、协议、路径),且 OPTIONS 路由注册位置必须与业务路由在同一个 Party 层级下。漏掉任一环,前端跨域就卡在预检阶段,连真正的 API 请求都发不出去。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











