Iris 中用 ctx.Redirect() 实现 301/302 跳转需传绝对路径或完整 URL，避免相对路径；必须显式 return 终止 handler，否则 panic；目标路由须已注册且通过中间件校验。
使用 ctx.Redirect() 实现 301/302 跳转
Iris 中最直接的跳转方式是调用上下文的 Redirect() 方法，它默认发送 302（临时重定向），传入状态码可改为 301（永久重定向）。
常见错误是传入相对路径（如 "./login" 或 "login"），Iris 不会自动补全 Host 和 Scheme，会导致跳转到错误地址甚至 404。必须提供完整 URL 或以 / 开头的绝对路径。
-
ctx.Redirect("/dashboard", 301)→ 跳转到同域下的 /dashboard（推荐） -
ctx.Redirect("https://example.com/home", 302)→ 跳转到外部站点 -
ctx.Redirect("login", 302)→ ❌ 错误：会被解释为当前路径下的子路径，比如从/admin/user发起，实际跳向/admin/login
在路由处理函数中提前终止后续逻辑
Redirect() 不会自动中断 handler 执行，如果后面还有 ctx.JSON() 或 ctx.HTML()，Iris 会 panic 报错 "http: multiple response.WriteHeader calls"。
必须显式 return，否则请求流程失控：
app.Get("/old-path", func(ctx iris.Context) {
ctx.Redirect("/new-path", 301)
return // ✅ 必须加这一行
ctx.JSON(iris.Map{"msg": "this will never run"})
})
- 漏掉
return是新手高频踩坑点 - 若跳转逻辑被包裹在 if/else 或中间件中，更要检查所有分支是否都覆盖了 return
- 不建议用
panic()或ctx.StopExecution()替代 return —— 前者破坏性太强，后者在较新 Iris 版本中已不推荐
结合 ctx.StatusCode() 和 ctx.Header() 手动构造跳转
极少数场景需要精细控制响应头（比如添加 Cache-Control 或自定义 Location 行为），可绕过 Redirect()，手动设置：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
ctx.StatusCode(302)
ctx.Header("Location", "/custom-redirect")
ctx.WriteString("") // 空响应体，避免 Iris 自动写入默认文本
- 必须手动调用
WriteString("")或Write(nil)，否则 Iris 可能追加默认响应内容 - 该方式绕过了 Iris 的跳转校验逻辑，容易遗漏
Location头或状态码不匹配，调试时注意抓包确认响应头是否正确 - 仅在
Redirect()无法满足需求时使用，例如需要动态拼接 Location 且含特殊编码字符
跳转目标路由未注册导致 404 的排查
跳转本身成功（响应头含 Location、状态码 301/302），但浏览器打开后报 404，大概率是目标路径没在 Iris 中注册对应 handler。
Iris 不校验 Redirect() 参数是否真实存在，它只负责发响应。需人工确认：
- 目标路径是否在
app.Get("/target")等路由注册中？注意大小写和尾部斜杠（/user≠/user/） - 是否被中间件拦截（如 JWT 验证中间件对
/dashboard强制要求登录，而跳转未携带 cookie） - 是否用了子路由器（
sub := app.Party("/api")），但跳转指向了根路径以外的层级
跳转不是黑盒操作，它的终点必须是 Iris 已知且可达的路由节点。路径拼错、注册遗漏、中间件阻断——这三类问题占实际排障的九成以上。
