Buffalo框架路由不支持版本化特性，自v0.18起为静态编译期匹配，不解析{version}占位符，须硬编码/v1/v2路径；app.Group仅作前缀拼接，无运行时切换能力；OPTIONS预检需显式注册，否则跨域失败。

Buffalo 框架没有“路由新版本特性”这个概念——它的路由系统自 v0.18 起就稳定为静态编译期匹配，不支持运行时动态版本分发、语义化版本路由（如 `/api/{version}/users`）、或自动 fallback 到兼容版本。所谓“新特性体验”，实际是开发者误将中间件、Group 或自定义 router 的 hack 当成官方能力。

Buffalo 路由根本不支持 {version} 占位符

你不能写 app.GET("/api/{version}/users", handler) 并指望 Buffalo 自动提取 version 参数做逻辑分发。它的底层用的是 github.com/gorilla/mux 的 fork，但移除了 path param 解析能力（仅保留 *x 通配），{version} 会被当字面量匹配，404 是唯一结果。

• 所有带版本的路径必须硬编码：比如 /api/v1/users、/api/v2/users
• 别依赖 app.Group("/api/v1", ...) 实现版本隔离——它只是字符串前缀拼接，不提供运行时路由切换能力
• 若真需要灰度或 AB 测试，得替换底层 router（如直接集成 gorilla/mux），Buffalo 原生不支持

为什么中间件里 parse version 失效？

因为 Buffalo 的路由匹配发生在中间件执行之前。请求来了先查 route 表，没匹配到就直接 404，根本进不到你的中间件里。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

• 错误做法：app.Use(versionMiddleware) 试图在中间件里读 c.Request().URL.Path 并重写路径——晚了，已经 404
• 正确做法：用 strings.HasPrefix 在中间件里校验已匹配成功的路径是否合法，比如只允许 /api/v1/ 和 /api/v2/
• 必须把该中间件注册在 app.Use() 最前面，否则可能被日志、auth 等中间件提前拦截

怎么让 v1 和 v2 共存且不互相干扰？

靠常量 + 显式注册，不是靠 magic。

• 统一定义：const UserListV1 = "/api/v1/users"、UserListV2 = "/api/v2/users"，全项目只从这里取值
• v1 接口冻结后禁止修改 handler，只加注释标注 // DEPRECATED: use v2，不删不改
• v2 新增独立 handler，路径用 UserListV2，和 v1 完全解耦
• 不要在 v1 handler 里做 if version == "v2" { ... } 这种混写——破坏契约，增加测试成本

真正容易被忽略的是：Buffalo 的 app.Options 不会自动响应预检请求，哪怕你注册了 app.GET("/api/v1/users")，浏览器发来的 OPTIONS /api/v1/users 依然 404。必须显式写 app.Options("/api/v1/*x", optionsHandler)，否则跨域就断。