API 网关版本路由与弃用治理（Header/Path 版本、客户端迁移与监控）

API 网关版本路由与弃用治理（Header/Path 版本、客户端迁移与监控）关键实践与参数路由策略：按 `Accept`/自定义 Header 或路径 `/v1` `/v2` 路由到不同后端。弃用治理：设置弃用窗口与告警；在旧版本返回 `Deprecation`/`Sunset` 头。监控：统计客户端版本分布与调用占比；针对大客迁移制定计划。验证方法灰度流量与 A/B 验证；监控错误率与延迟变化。观察迁移进度与剩余旧版本调用；阶段性下线策略。合同/Schema 与路由一致性回归测试。注意事项版本策略与客户端发布节奏要对齐；避免断崖式变更。与鉴权/限流策略一致；老版本安全策略不放宽。文档与 SDK 更新同步，降低迁移成本。