路由注册必须在beego.run()前完成，通常放在routers/router.go的init()函数中；beego.router等仅追加规则到队列，beego.initrouter在run()内首次构建基数树，之后只读线程安全。
beego.Router 和 beego.InitRouter 的调用时机差异
路由树不是在 beego.Run() 启动时才构建的，而是在所有 beego.Router、beego.Get 等注册函数执行后，由框架内部自动触发初始化。关键点在于：这些注册必须发生在 beego.Run() 之前，且通常放在 routers/router.go 的 init() 函数中。
如果你把路由注册写在某个控制器方法里（比如 func (c *MainController) Get() { beego.Get("/late", ...) }），它不会生效——因为此时路由树早已冻结，后续调用会被静默忽略。
-
beego.Router等函数只是将路由规则追加到全局待注册队列，并不立即建树 -
beego.InitRouter是框架私有函数，在beego.Run()内部首次被调用，负责把队列转为基数树（Radix Tree） - 多次调用
beego.InitRouter不会重建树，只会跳过（有保护逻辑）
动态参数和正则路由对树结构的影响
Beego 的基数树能高效处理带 :id 或 *.* 的路径，但前提是这些模式在注册时就确定。一旦树建好，就不能再往里“热插拔”新动态段或正则分支。
常见误区是以为 @download/*.* 这类正则路由会退化为线性扫描——其实不会。Beego 把正则约束提取为节点属性，匹配时仍走 O(k) 路径查找，只在最后一步才用 regexp.MatchString 校验完整路径。性能瓶颈通常出现在正则本身过于宽泛（如 .*），而非路由树结构。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 路径中每一段静态前缀（如
/api/v1/users）都对应树的一条确定分支 -
:id会被统一抽象为一个“参数节点”，不增加树深度 - 含
@的正则路由会额外生成一个regexNode，匹配失败时才 fallback 到其他规则
并发请求下路由匹配是否线程安全
是线程安全的。基数树结构在初始化完成后是只读的，所有 goroutine 共享同一份节点数据，无锁访问。匹配过程不修改任何字段，仅做字符比对和指针跳转。
但要注意：如果你在中间件或控制器里手动调用 beego.AddRoute（非标准用法），就会破坏这个前提。框架未对此类运行时变更做同步保护，可能导致树状态不一致或 panic。
- 标准路由注册（
beego.Get/beego.Router）必须在启动前完成 - 树构建后，
beego.BeeApp.Handlers指向的处理器映射表也是不可变的 - 实测 10k 并发 QPS 下，路由匹配耗时稳定在 50–200ns/次，无明显竞争毛刺
如何验证路由树是否按预期构建
没有公开 API 直接导出树结构，但可通过日志和调试手段确认关键行为：
- 启动时加
beego.BeeLogger.Level = logs.LevelDebug，会输出每条注册路由及其解析后的 pattern 类型（static / param / regex） - 故意注册冲突路由（如同时
beego.Get("/user/:id", ...)和beego.Get("/user/new", ...)），观察是否报 warning：“conflict route” - 用
curl -v http://localhost:8080/xxx触发 404，看日志里是否显示 “no match for /xxx”，说明树已生效且未 fallback 到兜底逻辑
真正容易被忽略的是：路由树初始化依赖 _ "app/routers" 这行导入语句的执行顺序。如果忘记在 main.go 中导入该包，init() 不会运行，整个路由表为空——服务起来却完全不报错，只对所有请求返回 404。
