Iris路由匹配错误的根本原因是按注册顺序和字面量精度匹配，不支持显式优先级；如同时注册 /users/{id:int} 和 /users/export，后者会被前者误匹配，因 {id:int} 仅校验类型而不排斥字符串。
为什么Iris路由会匹配到错误的Handler
根本原因不是“写了两个相似路径”，而是Iris按注册顺序+字面量精度做匹配，不支持像ASP.NET Core那样显式设优先级。比如同时注册 /users/{id:int} 和 /users/export，请求 /users/export 会命中前者——因为 {id:int} 的约束只校验类型，不排斥字符串 "export"，而Iris在匹配时先扫到这个带参数的路由就停了。
用Party分组+精确字面量路由前置
把高确定性路径（如 /health、/api/v1/status）放在分组最前面，再放带参数的泛化路由。Party本身不改变优先级，但能强制你组织注册顺序：
- 先调用
api := app.Party("/api") - 紧接着写
api.Get("/status", statusHandler)（字面量） - 最后写
api.Get("/users/{id:int}", userHandler)（参数化）
这样即使路径结构相似，也能靠注册次序控制流向。别依赖“更长路径优先”——Iris没这机制。
给参数加正则约束避免误匹配
{id:int} 太宽泛，export 被当成整数解析失败后仍可能被后续中间件处理，导致行为不可控。改用正则限定实际接受的值范围：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 写成
/users/{id:string regexp(^[0-9]+$)}，确保只收纯数字 - 导出接口单独写
/users/export，不塞进参数路由里 - 通配符
{*path}必须放在所有路由末尾，否则它会吃掉一切
注意：正则写错会导致整个路由注册失败，启动时抛 panic，别用 .* 这类无界表达式。
调试时用app.Logger().Infof打出路由注册快照
Iris不提供内置路由列表打印，但可以在 app.Run() 前手动遍历 app.Router.Lookup（需反射），更简单的是加日志确认注册顺序：
app.Get("/api/status", func(ctx iris.Context) {
app.Logger().Infof("route registered: /api/status")
ctx.WriteString("ok")
})
app.Get("/api/users/{id:int}", func(ctx iris.Context) {
app.Logger().Infof("route registered: /api/users/{id:int}")
ctx.JSON(iris.Map{"id": ctx.Params().GetIntDefault("id", 0)})
})
启动日志里看到顺序和你写的完全一致，就说明没被其他包或init函数悄悄覆盖。最容易被忽略的是第三方中间件自动注册的健康检查路由，它们可能在你不知情时插在前面。
