微服务 API 变更在生产环境如何做？“版本化 API”与“同服务新增 endpoint”各有什么取舍？

How do you evolve microservice APIs in production? Tradeoffs between API versioning and adding new endpoints?

题目类型: 技术面试题

这是一道技术面试题，常见于澳洲IT公司面试中。

难度: medium

分类: System Design

标签: api evolution, versioning

参考答案摘要

答案 常见两种策略： 版本化 （v1/v2 并行，消费者逐步迁移）优点是迁移路径清晰；缺点是长期维护多版本成本高，修 bug 可能要双写。另一种是 同服务新增 endpoint （保留旧接口，新需求走新接口，迁移完成后删除旧接口）优点是维持“单版本”运维更简单；缺点是需要更谨慎的兼容设计与迁移监控。实践中常配合 CDC、灰度与观测指标。

本题提供 STAR 原则详细解答和技术解析，登录匠人学院学习中心即可查看完整答案。