Iris认证失败时ctx.Next()仍执行,因它仅表示“继续”,不自动终止流程;必须用ctx.StopExecution()显式中断,且401响应需手动调ctx.JSON()并确保在StopExecution前执行。

认证失败时为什么 ctx.Next() 还会执行
因为 ctx.Next() 只是“继续执行后续 handler”,它不关心前面有没有校验失败。如果你在 JWT 中间件里写了 if !valid { ctx.StatusCode(401); ctx.StopExecution() },但后面还跟了个 ctx.Next(),那它会在失败路径里也调用——这会导致 panic 或返回错误数据。
正确结构必须是:校验失败就终止,成功才放行。
- 别写成
ctx.Next()放在 if 外面或 else 里套一层空逻辑 - 失败分支必须调
ctx.StopExecution(),不能只设状态码 - 别依赖
return终止——Iris 不会自动捕获中间件里的 return,仍可能继续执行 - 验证通过后记得调
ctx.User.Set(&user),否则后续 handler 拿不到用户信息
401 响应体为空或格式错乱怎么办
Iris 不会自动帮你渲染 401 的 JSON 错误体。只调 ctx.StatusCode(401) 后直接 ctx.StopExecution(),前端收到的是纯状态码、无 body、Content-Type 缺失,容易被当成网络错误。
- 必须手动写响应:
ctx.JSON(iris.Map{"error": "unauthorized"})或ctx.Text("Unauthorized") - 确保
ctx.JSON()在ctx.StopExecution()之前调用,否则不生效 - 别用
ctx.ResponseWriter().Write()写原始字节——它绕过 Iris 的 Content-Type 自动推断,前端解析 JSON 会失败 - 如果用了自定义错误模板,注意中间件中不能调
ctx.View()(View 渲染依赖完整生命周期,StopExecution 后不可用)
为什么认证失败后前端收不到 Access-Control-Allow-* 头
CORS 头是在中间件里注入的,但如果认证失败并提前 ctx.StopExecution(),而 CORS 注入逻辑写在 ctx.Next() 之后,那些头就根本不会写出去。
- CORS 相关 header 必须在认证逻辑之前设置,或至少放在同一中间件的固定位置(比如开头)
- 推荐把 CORS 注入和认证拆成两个中间件,并用
app.Use(corsMiddleware, authMiddleware)保证顺序 - 若合并写,CORS 设置代码要放在最外层,不要包裹在 if/else 里
- OPTIONS 预检请求本身不带 Authorization,必须在中间件开头用
ctx.Method() == "OPTIONS"特殊放行,否则连预检都过不去
Session 认证失败时 cookie 没清除干净
登录失败或登出时,只调 ctx.Logout() 不够。Iris 的 ctx.Logout() 默认只清 session 存储,但客户端 cookie 仍存在,下次请求可能被旧 session ID 继续识别。
- 显式调
ctx.RemoveCookie("session_id")(cookie 名需和SetCookieKV一致) - 注意 path 和 domain 必须匹配,否则删不掉:
iris.CookiePath("/")设置了,删除时也要传相同参数 - 如果用了
CookieHTTPOnly(true),JavaScript 删不了,必须服务端删 - 登出后建议再设一个过期 cookie 强制覆盖:
ctx.SetCookieKV("session_id", "", iris.CookieExpires(time.Now().Add(-1*time.Hour)))
实际中最容易被忽略的是:认证中间件的退出点必须唯一且明确。不是所有地方 return 都算退出,不是所有 401 都带 body,更不是所有 cookie 删除都会生效——每个环节都要对齐 HTTP 协议语义和 Iris 的执行模型。











