Echo框架中用c.Redirect()实现301/302跳转最干净可控，需显式注册旧路径并手动拼接查询参数，禁用通配符或标准库http.Redirect封装。
直接用 e.GET 或 e.Any 配合 c.Redirect() 就能完成路径重定向，不需要中间件、不依赖 Nginx，也不该用 rewrite 规则模拟——那是反模式。
用 c.Redirect() 做 301/302 跳转
这是最干净、最可控的方式。Echo 的 Redirect() 会设置响应状态码和 Location 头，并自动终止后续 handler 执行（不会出现 “write to body after headers sent” 错误）。
常见错误是手动调用 http.Redirect() 却忘了 return，导致后续逻辑仍被执行。
-
c.Redirect(http.StatusMovedPermanently, "/new-path")→ 301 永久跳转 -
c.Redirect(http.StatusFound, "/login")→ 302 临时跳转（默认行为） - 目标路径可以是绝对 URL（如
"https://example.com/home"），也可以是相对路径（如"/dashboard"） - 注意：相对路径会被自动补全为当前 host + path，不是基于当前请求的完整 URL 重写
匹配旧路由并重定向到新路径
当 API 版本升级或 URL 结构调整时，需要把旧路径显式映射为跳转逻辑，而不是靠全局 rewrite 或 Nginx 层兜底——否则前端、爬虫、监控都可能漏掉变更信号。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
示例：把已废弃的 /v1/users 重定向到 /v2/users
e.GET("/v1/users", func(c echo.Context) error {
return c.Redirect(http.StatusMovedPermanently, "/v2/users")
})
e.GET("/v1/users/:id", func(c echo.Context) error {
id := c.Param("id")
return c.Redirect(http.StatusMovedPermanently, "/v2/users/"+id)
})
- 必须单独注册每个要跳转的旧路径，不能靠通配符“代理式跳转”，否则会丢失语义（比如
/v1/users?sort=name里的 query 参数不会自动透传） - 如果 query 参数也要保留，得手动拼接：
c.Request().URL.RawQuery，再组合进新 URL - 别用
e.Any("/v1/*", ...)统一跳转——它会覆盖所有方法（包括 POST），而重定向对非 GET/HEAD 方法语义不安全
避免用 echo.WrapHandler(http.HandlerFunc(...)) 模拟重定向
有人试图用标准库 http.Redirect 包一层 handler 再用 echo.WrapHandler 注册，这会导致两个问题：
- 绕过了 Echo 的上下文生命周期管理，
c.Next()和中间件链失效 - 无法使用
c.Get()/c.Set()等 Context 方法，调试和扩展困难 - 容易在 handler 里漏掉
return，引发 header 已发送错误
真正需要复用跳转逻辑时，应封装成普通 handler 函数，而不是嵌套标准库 handler：
func redirectOldToNew(status int, target string) echo.HandlerFunc {
return func(c echo.Context) error {
return c.Redirect(status, target)
}
}
// 使用
e.GET("/legacy/home", redirectOldToNew(http.StatusMovedPermanently, "/home"))
最易被忽略的一点：重定向目标路径是否带 trailing slash，直接影响浏览器缓存行为和后续路由匹配。例如 /admin → /admin/ 是一次跳转，而 /admin/ → /admin 可能触发二次跳转（尤其配合 RemoveTrailingSlash 中间件时）。路径末尾斜杠必须和目标服务的真实路由严格一致。
