Echo的Rewrite中间件在应用层重写路径,需用e.Pre()注册,支持“/old”→“/new”式字符串映射及通配符*,不支持正则捕获,规则按最长前缀优先匹配,重写仅影响r.URL.Path,不触发二次重写,失败静默无报错。

用 Rewrite 中间件做路径重写,不是靠 proxy_pass 或 Nginx 规则
Echo 自带的 Rewrite 中间件专用于在 Go 层做请求路径改写,比如把 /v1/users 改成 /users 再进路由匹配。它和 Nginx 的 rewrite 指令逻辑类似,但发生在应用层,不依赖反向代理配置。
关键点是:必须用 e.Pre() 注册,不能用 e.Use() —— 否则路由已经匹配完了,重写就失效了。
-
Rewrite规则在路由解析前执行,影响后续所有路由匹配行为 - 规则是字符串映射:
"/old" → "/new",支持通配符*(如/api/v1/* → /v1/*) - 不支持正则捕获组,要复杂逻辑得自己写中间件或用
echo.HTTPError跳转
Rewrite 规则顺序很重要,先定义的优先匹配
规则按字典序+插入顺序生效,但 Rewrite 中间件内部会把最长前缀的规则排前面。不过别依赖这个,显式控制更可靠。
常见踩坑:写了 "/user" → "/users" 和 "/user/profile" → "/profile",结果前者先把后者也匹配了。正确做法是把更具体的放前面:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
e.Pre(middleware.Rewrite(map[string]string{
"/user/profile": "/profile",
"/user": "/users",
}))
- 路径必须完全匹配,
/user不会匹配/user/(末尾斜杠不同) - 重写后路径不会再次触发
Rewrite,避免循环 - 重写只改
r.URL.Path,原始 URL 的查询参数、Host、Method 全部保留
静态资源路径重写容易和 Static 路由冲突
如果你同时用了 e.Static() 挂载 /static,又写了 Rewrite 把 /assets 重写成 /static,那请求 /assets/logo.png 会被先重写为 /static/logo.png,再被 Static 处理——这看似合理,但要注意文件系统路径是否对齐。
-
e.Static("/static", "./public")表示访问/static/x时读取./public/x - 如果重写后变成
/static/logo.png,就得确保./public/logo.png存在,而不是./public/static/logo.png - 更安全的做法是直接用
e.Static("/assets", "./public"),省去重写环节
重写失败时没有报错,只能靠日志或调试中间件确认
Rewrite 中间件静默失败:规则不匹配就不动路径,也不会 log 或 panic。你看到 404,可能只是规则没生效,而不是路由没定义。
- 加个简单调试中间件,打印
c.Request().URL.Path,确认重写是否发生 - 注意路径开头的
/:规则键必须带前导斜杠,"user" → "/u"是无效的 - 开发期建议用
curl -v http://localhost:1323/old看响应头Location是否出现(说明被跳转了,而非重写)——那是你误用了Redirect而非Rewrite
重写本身不难,难的是判断该在哪一层做:Nginx 做动静分离、路径剥离;Echo 的 Rewrite 做 API 版本归一或兼容旧路径;真正需要语义解析的(比如 /post/go-web-framework → 查 slug)得交给业务 handler 自己 parse。别让一层承担所有职责。


















