beego路由是注册制而非配置制，错误使用会导致404或405而非报错；beego.get/post是单方法语法糖，beego.router需显式声明多方法映射；类型约束在匹配阶段硬过滤，不满足即跳过；子域名必须由nginx等前置代理处理，beego仅匹配url路径。
Beego 的路由不是“配出来”的，而是注册出来的；用错函数或漏参数，请求直接 404 或 405，而不是报错提示。
beego.Router 和 beego.Get/Post 的根本区别
两者都往同一个路由树里写规则，但行为完全不同：
-
beego.Get("/user/:id", handler)是语法糖，只绑定 GET 请求，且不支持正则约束、不支持多方法映射，控制器里必须叫Get()方法 -
beego.Router("/user/:id", &UserController{})默认 fallback 到*:Get，看起来像只响应 GET，但其实 PUT/DELETE 会返回 405 —— 因为没显式声明方法映射 - 要真正支持 RESTful 多方法，必须写第三个参数：
beego.Router("/user/:id", &UserController{}, "get:Retrieve;put:Update;delete:Remove") - 混用时最常踩的坑：写了
beego.Router("/api/:id", &ApiController{})就以为 POST 也能进，结果 405；或者写了beego.Post("/api", handler)却想在 handler 里处理 PUT，根本不会触发
:id:int 这类类型约束怎么才算生效
类型约束不是运行时校验，是路由匹配阶段的硬过滤：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
beego.Router("/item/:id:int", &ItemController{})中，/item/123能匹配，/item/abc直接跳过该路由（不 fallback，不继续匹配其他规则），最终 404 -
:id:int等价于:id([0-9]+)，不是数字就完全不认；:name:string对应[\w]+，不匹配中文、短横线、点号 - 可选参数要用
?:id形式：beego.Router("/api/?:id", &ApiController{})才能同时接受/api/和/api/123 -
this.Ctx.Input.Param(":id")只在匹配成功后有值；如果想兼容空值或任意字符串，别用类型约束，改用:splat或:path
子域名和 Host 头根本不能靠 beego.Router 处理
Beego 不读取 Host 请求头，所有路由只基于 Request.URL.Path 匹配：
- 写
beego.Router("admin.example.com/user", &AdminController{})没用 —— 实际收到的路径是/user，而你注册的是字面量admin.example.com/user - 框架启动监听的是
0.0.0.0:8080，不绑定任何域名；HTTP/1.1 的 Host 是 header 字段，不是 URL 路径的一部分 - 真实生产中必须用 Nginx 做前置分流：
admin.example.com → proxy_pass http://127.0.0.1:8081/admin/，然后 Beego 里用beego.Router("/admin/:action", &AdminController{}) - 如果非要代码层隔离，只能手动读
c.Ctx.Request.Host做 if 判断，但这不属于路由系统能力，也不推荐
路由匹配发生在 Controller 实例化之前，类型约束失败、Host 不匹配、方法未声明，都不会进 Controller；最容易忽略的是：你以为它会 fallback，其实它直接放弃。
