Beego路由需精准匹配逻辑、参数提取与Controller生命周期协同，否则易404或参数丢失；Router绑定Controller实例并调用对应方法，Get/Post绑定闭包函数且无MVC字段；正则参数需手动写全如:oid([a-z0-9-]+)，可选段用?:前缀，.与/语义不同；RESTful映射中方法不存在会panic，*:Index不处理OPTIONS，多method共享需手动判Method；AutoRouter仅扫导出方法、路径固定、不可排除、启动慢，生产禁用；路由匹配在filter前，Param失败导致链路中断。
Beego 的路由不是“配完就能用”，关键在匹配逻辑、参数提取方式和 Controller 生命周期的配合。直接套模板容易 404 或参数拿不到。
beego.Router 和 beego.Get/Post 的本质区别
两者注册的路由都走同一套 trie 匹配引擎，但行为差异极大：
-
beego.Router绑定的是Controller实例，请求进来后会 new 一个 controller，再根据 HTTP method 调用对应方法（如Get()、Post()），参数通过this.Ctx.Input.Param(":id")拿 -
beego.Get、beego.Post等绑定的是闭包函数，不经过 controller 生命周期，ctx是裸的*context.Context，必须手动解析参数：ctx.Input.Param(":id")同样可用，但没有this.TplName、this.Data等 MVC 辅助字段 - 混用时注意：同一个路径不能既用
Router又用Get，后者会覆盖前者（框架按注册顺序优先级处理，函数式路由优先级更高）
正则参数和类型约束的实际写法
看似简单的 :id:int 写法，背后是框架自动展开为 :id([0-9]+)，但很多场景它不够用：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 匹配带连字符的 ID：
beego.Router("/order/:oid([a-z0-9-]+)", &OrderController{})，不能写成:oid:string（后者只匹配[\w]+，不含-） - 可选路径段必须用
?:前缀：beego.Router("/api/v1/users/:id?:format", &APIController{})才能同时匹配/api/v1/users/123和/api/v1/users/123/json -
*.和/*容易混淆：/download/.*中:path和:ext自动拆分；/files/*中:splat拿到完整剩余路径，但注意它不包含开头的/ - 所有正则需转义特殊字符，比如匹配字面量点号要写
\.，而.在正则里是通配符
RESTful 方法映射中第三个参数的陷阱
beego.Router("/api/users", &UserController{}, "get:GetUsers;post:CreateUser") 这种写法看着清晰，但实际有三处隐性风险：
- 如果 controller 里没定义
GetUsers()方法，运行时报 panic，不是 405 —— 框架在注册阶段就反射检查方法存在性 -
"*:Index"表示任意 method 都进Index()，但OPTIONS请求默认不会触发 filter，若你依赖BeforeExec做 CORS，得额外加beego.InsertFilter("/api/.*", beego.BeforRouter, corsHandler, true) - 多个 method 共享一个方法时（如
"get,put,delete:Handle"），无法在方法内区分原始 method，得靠this.Ctx.Input.Method手动判断，别指望框架自动分发
AutoRouter 的适用边界与调试手段
beego.AddAuto(&UserController{}) 看似省事，但它只扫描导出的 public 方法，且路径生成规则固定（小写 controller 名 + 小写方法名），极易失控：
- 方法名含下划线（如
GetUserInfo()）会被转成/user/getuserinfo，不是预期的/user/info - 想排除某个方法？不行 —— AutoRouter 没提供 ignore 列表，只能改名或挪到非 controller 结构体里
- 查到底注册了哪些路由？启动时加
beego.BeeLogger.Level = logs.LevelDebug，日志里会打印所有已注册路由；或者运行时访问/debug/beego/routers（需开启 Admin 插件） - 生产环境禁用 AutoRouter：它依赖 runtime 反射，影响启动速度，且路径不可控，CI/CD 环境建议全用显式
Router或Get
最常被忽略的一点：路由匹配发生在所有 filter 之前，所以 Param 提取失败（比如正则不匹配）会导致整个请求链路中断，连 FinishRouter filter 都不执行 —— 错误日志里可能只有一句 “no match router”，得从 beego.Debug 日志逐行看 trie 匹配过程才能定位。
