HTTPS重定向必须用e.Pre()注册,路径重写用e.Use()即可;301/307语义需明确,skipper可排除特定路径,手动redirect后务必return。

直接用 middleware.HTTPSRedirect() 或 middleware.Rewrite() 就能生效,但必须注意注册时机和重定向状态码语义——错放位置或乱设 Code 会导致 301/307 行为异常、循环跳转或 headers already written 错误。
HTTPS 重定向必须用 e.Pre() 注册
HTTP → HTTPS 跳转属于「请求进入前」的强制干预,必须在路由匹配前执行。如果写成 e.Use() 或 e.GET(...) 内注册,请求已进入路由逻辑,此时再重定向会触发 write to body after headers sent 错误。
-
e.Pre(middleware.HTTPSRedirect())是最简写法,默认用http.StatusMovedPermanently(301) - 若需临时跳转(如测试环境),改用
middleware.HTTPSRedirectWithConfig()并显式设Code: http.StatusTemporaryRedirect(307) - 不要在 handler 里手动调
http.Redirect()后忘记return,Echo 不会自动终止后续逻辑
middleware.Rewrite() 适合路径级重定向
它不是发 HTTP 3xx 响应,而是内部重写 URL 路径后继续走原路由逻辑,适用于 /old → /new 这类同域路径映射,不改变浏览器地址栏。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 规则是字符串映射:
"/old": "/new",支持通配符:"/api/*": "/v1/$1" - 注意顺序:越具体的规则越往前放,
"/users/*/posts/*"要比"/users/*"先定义,否则后者会提前截断 - 它不发重定向响应,所以不会触发浏览器刷新,也不受
Pre()/Use()影响,用e.Use()即可
自定义重定向中间件要小心 skipper 和 redirectcode
所有 redirect 类中间件(WWWRedirect、NonWWWRedirect、AddTrailingSlash)都接受 RedirectConfig 或 TrailingSlashConfig,其中两个字段最关键:
-
redirectcode:决定跳转类型。301 表示永久迁移(会被浏览器缓存),302/307 更适合开发调试;设错会导致 SEO 问题或本地测试反复跳转 -
skipper:用于跳过某些路径,比如skipper: func(c echo.Context) bool { return c.Request().URL.Path == "/health" },避免健康检查端点也被重定向 - 没传
redirectcode时默认是 301,线上切 HTTPS 前建议先用 302 验证逻辑,确认无误再切 301
真正容易被忽略的是:重定向中间件一旦触发,Echo 就不再执行后续 handler,但如果你在中间件里自己手写 http.Redirect() 却漏了 return,后续代码仍会跑,轻则日志混乱,重则 panic 或返回双响应体。










