需通过app.WrapRouter在路由匹配前改写ctx.Request().URL.Path，如转小写实现大小写不敏感；或用Party+Handle结合glob模式（如*.png）分流扩展名请求，避免在中间件中修改Path后调ctx.Next()，因其不触发重匹配。
如何用 iris.Router 注册自定义路径匹配逻辑
Iris 默认不支持正则捕获组以外的任意路径解析（比如按文件扩展名分流、忽略大小写路由），必须通过中间件或自定义 Router 实现。核心思路是：在请求进入路由匹配前，手动改写 ctx.Request().URL.Path，再交由 Iris 原生路由处理。
常见错误是直接在 handler 里做重定向或二次 dispatch，这会绕过 Iris 的路由缓存和参数绑定机制，导致 ctx.Params() 为空、中间件重复执行。
- 改写路径必须在所有路由注册完成后、启动服务器前，调用
app.WrapRouter() - 修改后的路径需保持合法 URL 格式（不能含空格、未编码特殊字符）
- 若依赖
:param捕获，改写后路径仍需满足原路由定义的结构，否则匹配失败
用 WrapRouter 实现大小写不敏感路由
Iris 原生路由区分大小写，但 WrapRouter 可以在匹配前统一转小写，让 /API/Users 和 /api/users 都命中同一注册路径。
app.WrapRouter(func(w http.ResponseWriter, r *http.Request, router http.HandlerFunc) {
r.URL.Path = strings.ToLower(r.URL.Path)
router(w, r)
})
注意：此方式仅影响路径部分，查询参数（?q=Go）和 Host 头不受影响；若同时使用 Subdomain 或 Host 路由，需确保子域名本身也不区分大小写（通常 DNS 层已标准化）。
- 不要在
WrapRouter中做耗时操作（如 DB 查询），它会在每次请求时执行 - 若启用
app.UseGlobal()，该包装器仍早于全局中间件运行 - 与
app.Party("/v1")配合时，确保改写后的路径仍以/v1开头，否则子路由无法命中
用 Party + 自定义 Handle 实现扩展名路由分流
想把 /assets/logo.png 和 /assets/style.css 分发到不同 handler？别用通配符 GET("/assets/*file") 然后在 handler 里判断后缀——这样无法利用 Iris 的静态文件优化（如 ETag、Range 支持）。
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
正确做法是用 Party 绑定路径前缀，再用 Handle 注册具体方法和路径模式：
assets := app.Party("/assets")
assets.Handle("GET", "*.png", pngHandler)
assets.Handle("GET", "*.css", cssHandler)
assets.Handle("GET", "*.*", fallbackHandler)
这里 *.png 是 Iris 支持的 glob 模式，比正则更轻量；但注意它只匹配末尾，且不支持嵌套通配（如 */img/*.jpg 不生效）。
-
Handle注册的模式优先级高于普通Get/Post，同路径下后者会被覆盖 - glob 模式中
*只能出现一次，且必须在末尾（*.js✅，*.min.js❌） - 若需更复杂匹配（如排除某个目录），得回退到
WrapRouter+ 正则判断
为什么不用 ctx.Next() 在中间件里重写路径
有人尝试在中间件里改 ctx.Request().URL.Path 后调用 ctx.Next()，期望后续路由重新匹配——这不会生效。因为 Iris 的路由匹配在中间件执行前已完成，ctx.HandlerName() 已固定，改 Path 只影响当前 handler 内部逻辑，不影响路由分发本身。
真正起作用的只有两个时机：WrapRouter（最外层，请求刚进来）、或在 app.ConfigureContainer 中替换底层 router 实例（不推荐，破坏封装）。
- 调试时可用
ctx.Application().Router.Lookup(ctx.Method(), ctx.Path())查看当前匹配结果，确认改写是否及时 - 若启用
app.SetFireMethod(true)，还要注意FireMethod机制可能干扰自定义路径逻辑 - 多语言路由（如
/en/about→/about）这类场景，务必在WrapRouter中提取并移除 locale 段，再补回上下文值（如ctx.Values().Set("lang", "en")），否则 i18n 中间件拿不到语言标识
