重写默认路由规则必须用BeforeActivation；Iris MVC不自动映射方法名到路径，需手动调用b.Handle()绑定；By参数绑定需满足类型标注、命名规范及控制器注册三条件；路径冲突须通过子路径指定或拆分Party解决；正则匹配的URL需手动解码。
重写默认路由规则必须用 BeforeActivation，不能靠方法名推导
Iris MVC 不会自动把 GetUsers 方法映射到 /users，它只按字面匹配方法名和显式注册的路径。想改默认行为，唯一可靠方式是覆盖 BeforeActivation 回调，在里面调用 b.Handle() 手动绑定。
常见错误是以为加个 GetAll 就能响应 GET /，结果 404；或者在结构体里写 GetProfile 就期待框架自动识别 /profile —— 这些都不会生效。
-
BeforeActivation是控制器被激活前的钩子，此时路由尚未注册，可以安全干预 - 必须用指针接收者声明：
func (c *MyController) BeforeActivation(b mvc.BeforeActivation) -
b.Handle("GET", "/custom", "MyHandler")中第三个参数是方法名字符串，不是函数引用 - 若方法名含大小写混合（如
GetUserProfile），字符串里必须完全一致，不能写成getuserprofile
By 参数绑定 + 自定义路径 = 必须显式声明类型和键名
当你在 BeforeActivation 里注册带参数的路径，比如 /user/{id:int64}，控制器方法里想用 ById int64 接收，有三个硬性条件缺一不可：
- 路径中必须标注类型：
{id:int64}，不能只写{id} - 控制器方法参数名必须是
By+ 键名首字母大写：ById，不是byId或ID - 该控制器必须已通过
mvc.Application.Handle()注册，普通app.Get()不触发 By 绑定
漏掉任意一条，ById 都会是零值，且无任何错误提示——这是最常踩的静默坑。
多个控制器共用同一 Party 前缀时，路径冲突怎么解
如果两个控制器都挂载在 app.Party("/api") 下，又都在 BeforeActivation 里注册了 GET /users，后注册的会覆盖前一个，但 Iris 不报错也不警告。
解决方式只有两种：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 在
BeforeActivation内部用b.Router().Get()显式指定子路径，例如b.Router().Get("/v1/users", "GetV1Users") - 拆分 Party：为不同控制器分配独立前缀，如
app.Party("/api/v1")和app.Party("/api/v2")，再各自mvc.New().Handle()
别试图用中间件做路径分流——BeforeActivation 发生在路由注册阶段，中间件执行在请求时，时机完全不同。
重写规则里混用正则和通配符，URL 解码要自己动手
如果你在 BeforeActivation 里用 b.Handle("GET", "^/product/([0-9]+)$", "GetProduct") 启用正则模式，注意：iris.RewriteOptions{Regexp: true} 不会自动对捕获组做 url.PathUnescape。
比如请求是 /product/123%e4%b8%ad%e6%96%87，正则匹配成功，但传给 GetProduct(id string) 的 id 是原始编码字符串 "123%e4%b8%ad%e6%96%87"，不是解码后的 "123中文"。
必须手动处理：
func (c *ProductController) GetProduct(id string) string {
decoded, _ := url.PathUnescape(id)
// 后续逻辑用 decoded
}
这个细节在文档里藏得深，线上出过多次中文 ID 查询失败的问题。
