概述
破坏性变更若不提供过渡路径，消费方一次升级就会中断服务。先判定影响范围与受影响消费方、给出可迁移的兼容路径、公告时间线并监控旧路径用量，待用量归零或到期再移除，可把破坏性变更变成可控迁移。
关键步骤
- 判定变更性质并识别受影响消费方。
- 提供兼容路径：新字段、新接口或可选项。
- 公告时间线并监控旧路径用量。
- 用量归零或到期后移除旧行为。
验证
- 移除前旧路径用量归零。
- 迁移文档已发布并被使用。
- 消费方完成切换。
- 弃用公告归档。
决策点
应提供过渡期并以遥测跟踪，硬切换仅用于未使用或内部路径；移除宜以用量归零为准，时间表为兜底。
适用范围
本条目围绕「破坏性变更弃用工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。
建议在正式环境落地前先在预发或隔离环境演练一遍，把关键观测指标与负责人一并记录，确保出现异常时能快速定位并恢复。
// transitional: support both shapes
const quantity = req.body.quantity ?? req.body.qty;
// log usage of the deprecated field for migration tracking