面试题：Node.js 中 RESTful API 如何处理资源版本控制

Question

在使用 Node.js 开发 RESTful API 时，阐述至少两种实现资源版本控制的方法，并说明每种方法的优缺点。

Answer 1

1. URL 版本控制

• 实现方式：在 URL 中体现版本号，例如 /v1/users、/v2/users 。不同版本的 API 部署在不同的 URL 路径下。
• 优点：
  • 简单直观，易于理解和实现，客户端可以很清晰地根据 URL 选择使用哪个版本的 API 。
  • 不同版本的 API 可以独立开发、部署和维护，互不干扰。
• 缺点：
  • URL 不够简洁，随着版本增加，URL 变得冗长。
  • 如果需要对旧版本 API 进行修改，可能需要保留旧 URL ，导致维护成本增加。

2. HTTP 头信息版本控制

• 实现方式：通过在 HTTP 请求头中添加自定义字段来指定 API 版本，如 Accept: application/vnd.company+json; version=1.0 。服务器根据请求头中的版本信息来返回相应版本的资源。
• 优点：
  • URL 保持简洁，不会因为版本号而变得复杂。
  • 可以更灵活地支持多种版本共存，客户端和服务器端的耦合度相对较低。
• 缺点：
  • 实现相对复杂，需要服务器端解析请求头并根据版本信息进行相应处理。
  • 对于不熟悉这种方式的开发者，理解和使用成本较高，并且可能会受到一些客户端工具对自定义请求头支持程度的限制。