后端面试题：API 版本与兼容性

1. API 版本管理有哪些方式？

• URL 版本号：/api/v1/users。
• Header 版本号。
• Query 参数版本号。

2. 为什么需要保持向后兼容？

• 避免破坏现有客户端。
• 保持服务演进平稳。
• 支持多版本共存。

3. 如何设计兼容性演进策略？

• 通过新增字段而不是修改现有字段。
• 使用默认值处理缺失数据。
• 严格区分必需字段与可选字段。

4. 你如何处理接口弃用？

• 通过文档公告和版本策略通知用户。
• 支持一段时间的兼容期。
• 最终下线前做好迁移方案。

5. 版本管理对测试有什么要求？

• 需要覆盖不同版本的回归测试。
• 特别注意兼容性边界条件。

6. 何时才会考虑拆分出新版本？

• 当 API 结构发生重大变化时。
• 旧版本难以与新逻辑兼容时。
• 需要明确用户迁移路径时。

7. 你如何处理 API 的字段兼容性？

• 新增字段是安全的。
• 修改字段含义或类型需谨慎。
• 删除字段应通过版本升级处理。

8. API 设计中的幂等性如何保证？

• 通过幂等请求方法（PUT、DELETE）。
• 使用唯一请求 ID 防止重复执行。
• 对创建操作使用幂等 key 或幂等 token。