必须用 ctx.request().url.path 读原始路径，因其未被路由逻辑修改；该字段只读，不可直接赋值，路径重写应通过 party 分组、宏匹配或手动调用 handler 实现，避免破坏参数绑定与路由契约。
中间件里怎么拿到原始 URL 路径并安全修改
必须用 ctx.Request().URL.Path 读原始路径，不能依赖 ctx.Path() —— 后者可能已被路由匹配逻辑重写或规范化（比如自动去掉末尾斜杠）。Iris 的中间件执行时，ctx.Path() 返回的是「匹配后的路径」，而签名、灰度路由、API 版本转发等场景需要的是客户端发来的原始路径字符串。
-
ctx.Request().URL.Path是只读的，不能直接赋值修改；要“重写路径”，得靠 Iris 的ctx.Do(…)或手动触发新路由匹配 - 常见错误是试图
ctx.Request().URL.Path = "/new"，Go 会报错：cannot assign to struct field - 若只是想让后续 handler 看到不同路径，推荐用
ctx.SetCurrentRoute(...)+ctx.StopExecution()+ 显式调用目标 handler（不推荐）；更稳妥的是用ctx.Redirect()做 30x 跳转（适合外部可见变更） - 真正需要内部路径重写（如 /v1/users → /users），应使用
app.Party("/v1")分组 +HandleFunc中转，而不是在中间件里硬改
如何在中间件中实现 /api/v2/xxx → /api/v1/xxx 的内部转发
这不是简单的字符串替换，而是要绕过原路由匹配、触发新路径的 handler 执行。Iris 不提供类似 Express 的 next("route")，所以得手动模拟一次子请求上下文，但代价高、易出错。实际项目中更常用的是「路由分组 + 宏匹配 + 统一降级逻辑」。
- 注册两个分组：
app.Party("/api/v1")和app.Party("/api/v2")，后者中间件里用ctx.Params().Get("path")捕获剩余路径 - 构造新路径：
newPath := "/api/v1" + strings.TrimPrefix(ctx.Request().URL.Path, "/api/v2") - 别用
http.Redirect或ctx.Redirect—— 这会暴露重写逻辑给客户端，且改变 HTTP 方法语义 - 正确做法：在 v2 分组中间件中解析参数、校验权限后，直接调用 v1 对应的 handler 函数（需提前导出），传入同一
*context.Context；注意 handler 内部不能再调ctx.Next() - 风险点：v1 handler 若依赖
ctx.Path()做判断，会拿不到真实路径，建议统一从ctx.Request().URL.Path取原始值
为什么 ctx.URLParam() 在中间件里取不到 query 参数
ctx.URLParam() 依赖 Iris 内部的 query 解析缓存，而这个缓存默认在路由匹配后、handler 执行前才初始化。中间件若在 ctx.Next() 之前调用它，返回空字符串是常态——不是 bug，是执行时机问题。
- 安全取法：用
ctx.Request().URL.Query().Get("key")，它不依赖框架缓存，始终可用 - 如果路径里带 query（如
/user?id=123），且你又在中间件里做了路径重写（比如改成/admin/user），原始 query 不会自动保留，必须手动拼接：newURL := oldPath + "?" + oldQuery.Encode() - 别在中间件里反复调
ctx.Request().URL.Query()—— 每次都重新解析，有性能开销；可缓存到ctx.Values().Set("query", q)供后续使用 - 注意 URL 编码：query 值可能含
%20等，Query().Get()已自动解码，无需再调url.QueryUnescape
重写路径后怎么让 ctx.Param() 和 ctx.Params().Get() 仍然有效
做不到。Iris 的 ctx.Param() 和 ctx.Params().Get() 绑定的是「当前匹配的路由模板」，不是原始 URL。一旦你绕过原路由、手动跳转或调用其他 handler，这些方法就和新路径无关了——它们仍返回旧路由定义里的参数。
- 如果你重写了路径并希望复用参数提取逻辑，唯一办法是：在中间件里自己解析新路径，用正则或
strings.Split()提取关键段，存入ctx.Values() - 例如：
ctx.Values().Set("user_id", parts[2])，然后 handler 里用ctx.Values().GetString("user_id")替代ctx.Params().Get("id") - 宏类型校验（如
{id:uint64}）完全失效——中间件无权触发路由宏校验，这部分只能靠你自己做strconv.ParseUint并处理 error - 最省事的方案：放弃中间件内重写，改用
app.Get("/api/v2/{path:path}")+ 宏捕获，把版本适配逻辑放在 handler 开头，保持路由系统完整可控
Request.URL.Path 的底层字段。
