Beego中路径重写必须在beego.BeforeRouter阶段修改ctx.Request.URL.Path和RawPath并调用ctx.Abort()，否则路由仍按原路径匹配；重定向则可用ctx.Redirect(301/302)但需return终止后续流程。
能重写请求路径，但不能靠中间件“直接重定向”——Beego 中间件本身不提供 Redirect 或 SetStatus(302) 的语义封装，必须手动操作 c.Ctx.ResponseWriter 和 c.Ctx.Request，且重写后需主动终止后续流程，否则会继续走路由匹配甚至进 controller。
中间件里改 c.Ctx.Request.URL.Path 为什么没用？
Beego 的路由匹配发生在 BeforeRouter 阶段之后、BeforExec 阶段之前。如果你在 BeforeExec 或更晚注册的中间件里只改了 ctx.Request.URL.Path，但没重置内部路由状态，Beego 仍按原始路径匹配 controller，改了也白改。
- 真正生效的时机只有
beego.BeforeRouter阶段：此时路由尚未开始匹配，修改ctx.Request.URL.Path后，后续匹配会基于新路径 - 改完必须调用
ctx.Abort()或return，否则 Beego 会继续执行后续 filter 和 controller，造成逻辑错乱 - 不要用
http.Redirect—— 它会写 Header 并触发 302 响应，和“路径重写”是两回事；你要的是内部转发（类似 Nginx 的rewrite ... last），不是客户端跳转
正确做法：在 beego.BeforeRouter 阶段做路径替换
注册点必须是 beego.BeforeRouter，这是唯一能影响后续路由决策的位置。例如把所有 /v1/xxx 重写为 /api/xxx：
func RewriteV1ToAPI(ctx *context.Context) {
path := ctx.Request.URL.Path
if strings.HasPrefix(path, "/v1/") {
newPath := "/api/" + strings.TrimPrefix(path, "/v1/")
// 必须同时改 URL.Path 和 RawURL，否则某些中间件或日志可能读错
ctx.Request.URL.Path = newPath
ctx.Request.URL.RawPath = newPath
// 关键：终止当前 filter 链，避免重复处理
ctx.Abort()
}
}
// 注册时指定阶段
beego.InsertFilter("/*", beego.BeforeRouter, RewriteV1ToAPI)
-
"/*"是通配前缀，确保覆盖全部请求；若只想重写某类路径，可换为"/v1/" - 不要用
ctx.Redirect或ctx.Ctx.Output.SetStatus(302)，那是响应层动作，与路径重写无关 - 注意
RawPath也要同步更新，否则ctx.Input.URI()等方法可能返回旧值
想实现 301/302 重定向，该用什么？
如果目标是让浏览器跳转（比如 SEO 迁移、旧链接兼容），那就不是“重写”，而是标准 HTTP 重定向。这时中间件可以安全使用 ctx.Redirect，但要注意时机和状态码选择：
- 在任意 filter 阶段都可用：
ctx.Redirect(301, "/new-path")，它会设置LocationHeader 并写入状态码 - 别在
BeforeStatic里做重定向：静态资源处理器不走完整 filter 链，ctx.Redirect可能被忽略 - 301（永久）适合已下线的路径；302（临时）适合灰度切换场景；避免用 307/308，Beego 默认不保留 method/body，需手动处理
- 重定向后务必
return，防止后续逻辑干扰响应体
容易被忽略的边界情况
路径重写看似简单，但 Beego 的多阶段 filter 设计会让几个细节出问题：
- Query 参数不会自动迁移：改了
Path，但?a=1&b=2还在原RawQuery里，得手动拼接 - POST 请求重写后，body 不会丢失，但若中间件里已调用
ParseForm()，重写路径再进 controller 可能导致重复解析 - 静态资源路径（如
/static/）绕过路由系统，BeforeRouter对它无效；要重写静态路径，必须用beego.BeforeStatic阶段，并且只能影响文件系统路径，不能触发路由匹配 - 如果同时注册了多个
BeforeRouterfilter，顺序很重要：先注册的先执行，重写必须在其他依赖路径的 filter 之前
