标准答案
- 先标记废弃范围、替代接口、行为差异、最早下线日期和责任人，并在文档、SDK、响应 Header 或控制台中给调用方可见提示。
- 通过网关、日志和指标识别真实调用方、版本、调用量和关键业务路径，不能只根据代码仓库搜索决定是否下线。
- 提供迁移指南、示例、兼容层、SDK 升级和必要的灰度支持；对高风险调用方安排联调和回滚窗口。
- 在公告期内逐步限制新接入、告警高频旧调用，确认调用量降至可接受阈值后再按计划下线。
- 下线后保留一段可审计的错误提示和监控，确保遗留调用能被定位，而不是静默返回错误或重定向到语义不同的新接口。
题目解析
接口废弃的难点不在删除代码，而在未知消费者。外部合作方、旧移动端、脚本任务和缓存配置都可能比主应用更晚迁移。
过长的无限兼容会拖累维护，但过快下线会造成不可控事故；生命周期和观测让团队能在风险与成本间做判断。
常见误区
- 发布新接口后马上删除旧接口。
- 只发公告，不监控旧接口真实调用量。
- 把旧接口重定向到行为不同的新接口，掩盖语义破坏。