路由名称必须注册时立即设置且全局唯一,重复或非法字符(如空格、斜杠)会导致panic;推荐用小写+点分隔风格,如"api.users.list";名称需与URI参数键严格匹配,否则反向生成失败且无提示。

必须在注册路由时立即设置名称,不能事后补;名称重复会 panic,不是 warning。
用第三个参数直接传入名称字符串
这是最常用也最安全的方式。Iris 的 Get、Post 等方法都支持第三个参数作为路由名称:
- 名称必须是纯 ASCII 字符串,不能含空格、斜杠或点以外的符号(如
"user.detail"合法,"user detail"或"user/detail"会 panic) - 名称全局唯一,重复注册相同名称(哪怕在不同 HTTP 方法下)会导致启动失败,报错:
duplicate route name "xxx" - 推荐用小写字母 + 点分隔风格,比如
"api.users.list"、"admin.dashboard"
示例:
app.Get("/users", listUsers, "api.users.list")
app.Post("/users", createUser, "api.users.create")
app.Get("/users/{id:uint64}", getUser, "api.users.by_id")
通过返回的 *Route 实例设置 Name 字段
这种方式容易出错,仅适用于需要链式操作或动态命名的极少数场景:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 必须在调用注册方法后**立刻赋值**,不能跨 goroutine 或延迟执行
- 如果该路由被多次注册(比如在循环中),
home.Name = "xxx"可能覆盖前一次设置,且无任何提示 - 不支持在
Party分组内对子路由统一命名,每个都要单独处理
示例(不推荐日常使用):
home := app.Get("/", homeHandler)
home.Name = "home" // 必须紧跟上一行,否则可能失效
// 错误写法:下面这行不会生效,因为 Get 返回的是新 Route 实例
app.Get("/about", aboutHandler).Name = "about" // ← 这个赋值被丢弃了
名称必须与 URI 生成时的参数键严格匹配
路由名称本身只是个标识符,真正影响 URL 生成的是路径中的参数名和类型声明:
- 比如路由定义为
app.Get("/order/{oid:int min(1)}", handler, "order.detail"),那么生成 URL 时必须传iris.Map{"oid": 123},写成"id": 123会保留原始占位符/order/{oid:int min(1)} - 参数名大小写敏感,
oid≠Oid≠OID - 若用了宏(如
{id:uint64}),Iris 在匹配阶段就校验格式,但名称本身不参与校验——起错名只会影响反向生成,不会导致 404
名称一旦设错或漏设,模板里调用 {{ urlpath "xxx" }} 或代码里调用 c.Router().URI("xxx", ...) 就会静默失败,返回空字符串或原始路径模板。这种问题很难 debug,因为没有 panic,也没有日志提示。


















