Spring Boot微服务API版本控制实现

Question

需要修改Spring Boot微服务的现有契约（请求/响应有效负载），这实际上是破坏性的更改（不向后兼容）。而且在一段时间内支持合同的两个版本--直到所有客户都升级到更新的版本--是至关重要的。

为了实现这一点，已经决定使用URL版本控制策略（如/v1/{resource}和/v2/{resource}）。

现在，问题是在代码中实现这一点的最佳方式是什么？以下是两个建议的解决方案

>

扩展版本一(/v1)代码并单独维护它，直到支持该版本。这实质上意味着从master和build/deploy中裁剪分支，并维护同一服务的两个实例，每个实例分别支持v1和v2版本。

在同一个主分支中，引入一个单独的包（如service.api.v2.request)，并将所有api有效负载请求/响应类放在其中，并引入一个新的endpoint控制器来支持(/v2)。这种方法使单个实例能够支持这两个版本。

以上哪一个是更好的方法？或者有没有其他标准/更好的替代方案来实现这一点？Spring Boot是否为此类需求提供了开箱即用的支持？

Answer 1

这取决于控制器背后有多少共同性。如果各个版本一直到后端都有显著的不同，那么不同的分支可能更容易处理，但如果主要的差异在于控制器路径以及这些方法中涉及的输入和输出对象，那么两个分支可能会导致对两者都应用更改的痛苦，并且每次都要记住这样做--这种情况迟早会错过一个重要的修复。

这一切都是一种平衡，您需要在您的情况下权衡各种方法的维护成本，包括时间和精力、错误风险以及单独部署的成本。