Fiber 中动态增删路由需调用 RebuildTree() 才生效,因其路由匹配依赖启动时构建的 Trie 树;app.Get() 仅入栈不更新树,RemoveRoute() 也仅标记待删,重建前仍可访问;二者均非线程安全,仅限开发调试使用。

运行时动态增删路由在 Fiber 中是可行的,但不是常规用法——RebuildTree 和 RemoveRoute 仅适用于开发调试场景,生产环境应避免使用。
为什么不能直接调用 app.Get() 就生效?
Fiber 的路由匹配依赖前缀树(Trie),所有注册的路由在启动时被一次性构建成树结构;后续调用 app.Get() 等方法只是把新路由记入内部栈,并不会自动更新树。不调用 RebuildTree(),新路由对请求完全不可见。
- 现象:注册了
app.Get("/debug/test", handler)后立刻发请求,返回 404 - 根本原因:路由树未重建,新路径未纳入匹配逻辑
-
RebuildTree()是唯一触发树重建的公开 API,它会重新扫描全部已注册路由(含动态添加的)并生成新 Trie
RebuildTree() 的调用时机和限制
必须在路由注册完成后、且无并发写入时调用;它不是线程安全操作,也不适合高频触发。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 禁止在中间件或并发 handler 中调用,例如多个请求同时命中
/define并执行RebuildTree()可能导致 panic 或路由丢失 - 官方明确标注为 “very performance-intensive”,一次重建耗时随总路由数增长,v2/v3 均无优化
- 重建后,所有新注册的
GET路由会自动补上配套HEAD路由,行为与启动时一致 - 推荐只在 CLI 命令、管理端点或热重载脚本中使用,不要嵌入业务逻辑流
RemoveRoute() 怎么安全摘除旧路由?
RemoveRoute() 不会立即生效,它只是标记某条路由为“待移除”,真正清理要等下一次 RebuildTree()。
- 调用
app.RemoveRoute("GET", "/old/path")后,该路径仍可访问,直到你调用RebuildTree() - 路径必须完全匹配:方法名大小写敏感,路径带前导斜杠,通配符如
:id不参与匹配(即不能用/users/:id去删/users/123) - 若想替换实现,典型流程是:
RemoveRoute("GET", "/api/v1/users")→app.Get("/api/v1/users", newHandler)→RebuildTree() - 注意:
RemoveRoute不支持模糊匹配或批量删除,删错路径只能靠重建恢复
最易被忽略的一点:Fiber v3 虽然开放了这些 API,但文档反复强调“not thread-safe”和“for development only”;哪怕你在本地跑通了动态注册,只要部署到多实例或压测环境,就可能因竞态或性能抖动出问题。真要支持热插拔,建议改用外部网关路由或服务发现机制,而非框架内路由树操作。


















