Beego路由配置需关注注册时机、参数提取方式和匹配优先级；beego.Router绑定控制器方法，beego.Get/Post为函数式路由且优先级更高，正则与类型约束须严格匹配，路由顺序影响匹配结果。
Beego 的路由配置不是“写完就能用”，关键在注册时机、参数提取方式和匹配优先级这三点上。多数 404 或参数取不到的问题，都卡在这儿。
beego.Router 和 beego.Get/Post 等函数的区别在哪
它们底层都走同一套路由表，但注册逻辑和默认行为不同：
-
beego.Router("/user/:id", &controllers.UserController{})是控制器风格路由，自动按 HTTP 方法调用UserController里的Get()、Post()等方法；路径参数通过this.Ctx.Input.Param(":id")获取 -
beego.Get("/user/:id", func(ctx *context.Context) {...})是函数式路由，不涉及 Controller 实例，参数必须用ctx.Input.Param(":id")提取，且该闭包只响应 GET - 混用时注意：函数式路由优先级高于控制器风格路由。如果同时写了
beego.Get("/api", ...)和beego.Router("/api", &c.ApiController{})，前者会拦截所有 GET /api 请求，后者不会触发 - 别漏掉
init()函数的执行顺序 —— 所有路由注册必须在beego.Run()之前完成，否则无效
正则参数和类型约束怎么写才不踩坑
Beego 对路径参数的支持很灵活，但写错正则或类型标记会导致匹配失败或空值：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
beego.Router("/user/:id", &c.UserController{})：匹配/user/123，但不匹配/user/（末尾斜杠不能省） -
beego.Router("/user/:id([0-9]+)", &c.UserController{})：强制:id必须是数字，/user/abc直接 404 -
beego.Router("/user/:id:int", &c.UserController{})：等价于上面的正则写法，更简洁，但仅支持int和string两种类型标记 -
beego.Router("/file/:name(.*)", &c.FileController{})：匹配任意后缀，但注意:name取到的是abc.jpg而非abc；如需分离扩展名，得自己用path.Ext()解析 - 多个参数共存时，顺序必须严格对应，比如
/api/:year:int/:month:int/:day:int，少一个或类型错就匹配不上
RESTful 方法映射与自定义函数名怎么配
默认 Controller 方法名和 HTTP 方法名绑定（Get() 响应 GET），但业务复杂时需要解耦：
-
beego.Router("/api", &c.ApiController{}, "get:GetList;post:CreateItem")：明确指定 GET →GetList()，POST →CreateItem()，其他方法 405 -
beego.Router("/api", &c.ApiController{}, "get,put:CommonHandler")：GET 和 PUT 都进同一个方法，适合幂等更新场景 -
beego.Router("/api", &c.ApiController{}, "*:Fallback")：任何方法都进Fallback()，适合做统一入口或协议适配层 - 注意大小写：
"GET:list"无效，必须是小写 method 名 + 冒号 + 首字母大写的 Go 方法名 - 如果 Controller 方法签名不标准（比如缺
func()或带额外参数），运行时报 panic，不是 404
为什么路由注册了却 404？几个隐蔽原因
常见现象是代码写了路由、服务也启动了，但请求始终返回 404。真正原因往往不在路由本身：
- 项目结构没按 Beego 约定：
routers/router.go的init()没被 main 包 import（用了_ "myapp/routers"才行），否则整个文件不会执行 - 路径末尾斜杠不一致：
beego.Get("/user", ...)不匹配curl http://localhost:8080/user/（带斜杠），除非显式写成"/user/" - 开发模式下路由未热重载：改了
routers/router.go但没重启进程，旧路由表还在内存里 - 中间件提前终止了请求：比如某个
BeforeExec里调了ctx.Abort(401)，后续路由根本不会走到 - 静态文件路由干扰：如果启用了
beego.BConfig.WebConfig.StaticDir，而请求路径恰好落在静态目录规则内（如/static/xxx），会被直接返回文件或 404，绕过你写的 API 路由
最常被忽略的一点：Beego 的路由匹配是**从上到下顺序扫描**的，没有“最长前缀”或“正则优先级”机制。写路由时，更具体的规则（如 /user/:id:int）一定要放在更宽泛的规则（如 /user/:id）前面，否则宽泛规则永远先命中。
