直接用代码块初始化不同版本的API实例是最轻量、最可控的变量路由解法，通过独立实例隔离版本逻辑，自动加前缀、差异化中间件、分版本监控，并用结构体嵌套保障响应兼容性。

直接用代码块初始化不同版本的 API 实例，是最轻量、最可控的变量路由解法。它不依赖全局中间件或复杂网关配置，而是从应用启动那一刻起，就让每个版本拥有独立的路由上下文和状态空间。

用独立实例隔离版本逻辑

在 Lambda API 或 Gin 等框架中，不是写一个大路由表再加 if 判断版本，而是为每个版本创建专属实例：

Skill Weave Chains — 技能链路由引擎

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

下载

• Lambda API 示例：分别 require 并传入 version 配置，自动注入前缀

const apiV1 = require('../index')({ version: 'v1' })
const apiV2 = require('../index')({ version: 'v2' })

apiV1.get('/users', (req, res) => {
  res.json({ version: req.version, data: usersV1() })
})

apiV2.get('/users', (req, res) => {
  res.json({ version: req.version, data: usersV2WithRoles() })
})

• 这样 /v1/users 和 /v2/users 天然分离，无需手动拼接路径或解析请求头
• 每个实例的 req.version、中间件栈、错误处理都彼此独立

变量路由的关键：把版本号变成运行时上下文

所谓“变量路由”，本质是让路由行为能根据版本动态变化。初始化时注入 version，就等于把版本变成了整个实例的上下文变量：

• 路由注册时自动加前缀（如 /v1 → /v1/users），避免硬编码
• 中间件可读取 req.version 做差异化处理（如 v1 用 JWT，v2 支持 OAuth2.1）
• 日志、监控、指标采集可天然打上 version 标签，便于分版本分析调用量与错误率

配合结构体嵌套保障响应兼容性

变量路由解决的是“怎么进”，而数据结构决定“怎么出”。v1 和 v2 共享基础字段，v2 仅扩展：

type UserV1 struct {
  ID int `json:"id"`
  Name string `json:"name"`
}

type UserV2 struct {
  UserV1 // 继承所有 v1 字段
  Email string `json:"email,omitempty"`
  Role string `json:"role,omitempty"`
}

• v1 客户端收到 { "id": 1, "name": "Alice" }，完全无感知
• v2 客户端多拿到 email 和 role，不影响原有解析逻辑
• 业务处理器只需按版本返回对应结构体，无需条件判断字段存在性