如何在Iris框架中设置路由名称-Golang-PHP中文网

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

如何在iris框架中设置路由名称

必须在注册路由时立即设置名称，不能事后补；名称重复会 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 字段

这种方式容易出错，仅适用于需要链式操作或动态命名的极少数场景：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。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