beego路由生效需满足三条件：init()被触发、beego.router/beego.get在beego.run()前调用、控制器方法签名正确；漏任一环即404或panic。
Beego 的路由配置不是“写完就能跑”，关键在于 init() 函数是否被正确导入、beego.Router 和函数式路由（如 beego.Get）的调用时机是否在 beego.Run() 之前，以及控制器方法签名是否匹配。漏掉任一环，路由就 404 或 panic。
为什么 beego.Router("/path", &Controller{}) 不生效？
最常见原因是：控制器包没被 import，或者 _ "yourapp/routers" 没在 main.go 中以空白导入方式触发 init()。
-
routers/router.go中的func init()必须被 Go 运行时自动执行，否则所有beego.Router调用都不会注册 - 确保
main.go中有类似_ "yourapp/routers"的导入（注意下划线），不能写成"yourapp/routers" - 检查控制器结构体是否嵌入了
beego.Controller，例如：type IndexController struct { beego.Controller }，否则方法绑定失败 - 如果用了
beego.Router("/user", &UserController{}, "get:Get")，但Get()方法签名不是func(*UserController)，会编译报错或运行时 panic
beego.Get 和 beego.Router 的本质区别是什么？
beego.Get 是函数式路由，直接绑定闭包；beego.Router 是控制器式路由，依赖控制器方法反射调用。二者不能混用同一路径，否则后者覆盖前者（按注册顺序，后注册的生效）。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
beego.Get("/hello", func(ctx *context.Context) { ... })：轻量、适合原型或简单逻辑，不走 Controller 生命周期（Prepare/Finish不触发） -
beego.Router("/hello", &MainController{})：默认按 HTTP 方法调用对应方法（Get()、Post()），完整支持Prepare、Finish、URLMapping等 - 若想让
Router只响应 GET，应写成beego.Router("/hello", &MainController{}, "get:Get")，而非依赖默认行为——因为默认行为在runmode = dev下可能被自动路由干扰
正则路由中 :id 和 ?:id 有什么实际影响？
这决定了路径段是否为「必需」，直接影响 URL 匹配结果，且错误写法会导致 404 却无提示。
-
beego.Router("/api/:id", &APIController{})：强制要求/api/后必须跟一个非空路径段，/api/本身 404，/api/123和/api/user均匹配 -
beego.Router("/api/?:id", &APIController{})：:id是可选的，/api/、/api/123、/api/abc全部匹配，但/api/123/456不匹配（只允许一级子路径） - 参数值通过
this.Ctx.Input.Param(":id")获取，不是Query或Form；若未匹配到，返回空字符串，不会 panic - 不要写
?:id.html这类混合后缀，Beego 不解析扩展名，/api/123.html中的:id值是"123.html"，不是"123"
如何快速验证当前项目已注册的全部路由？
Beego 不提供内置命令行查路由，但可通过日志开关暴露注册过程——这是调试 404 最直接的手段。
- 启动前设置环境变量：
export BEEGO_LOG_ROUTER=true（Linux/macOS）或set BEEGO_LOG_ROUTER=true（Windows） - 或在
main.go中beego.Run()前加：beego.BeeLogger.Level = logs.LevelDebug，并确保conf/app.conf中loglevel = 4 - 启动后控制台会打印类似
[router] registered router: GET /, controller: controllers.MainController.Get的行 - 注意：
beego.Get注册的路由日志显示为anonymous function，而beego.Router显示具体控制器方法
真正容易被忽略的是：Beego 的路由注册发生在 init() 阶段，而控制器方法的反射调用依赖于结构体字段和方法导出规则。哪怕只是把 Get() 写成 get()（小写），整个路由就静默失效——没有编译错误，也没有日志提示，只有 404。
