面试题：微服务架构下API版本管理的常见策略有哪些

Question

在微服务架构体系中，阐述API版本管理常见的几种策略，并说明每种策略的优缺点。

Answer 1

基于 URL 的版本管理

• 优点：直观，易于理解和实现，客户端通过 URL 很容易明确使用的版本。
• 缺点：不够灵活，URL 变更可能影响搜索引擎收录等，且难以对不同版本进行细粒度控制。

基于请求头的版本管理

• 优点：对 URL 无影响，不会破坏现有 URL 结构，可在不改变 URL 的情况下灵活切换版本。
• 缺点：部分客户端可能不熟悉或不支持通过请求头指定版本，增加了客户端使用成本。

基于媒体类型（Content-Type）的版本管理

• 优点：符合 RESTful 原则，语义清晰，能够很好地与 HTTP 协议结合，可通过媒体类型实现不同版本资源的差异化处理。
• 缺点：同样存在部分客户端不熟悉的问题，且对服务端处理要求相对较高，需要精确解析媒体类型来提供对应版本服务。