如何确保 Thrift 对象向后兼容？

Question

我们目前正在使用 thrift 来开发我们的微服务。 当我最近遇到以下问题时。

假设下面是摘要对象的节俭合约，并且有一个 API 使用传递的摘要对象获取和更新摘要。

版本 - 1.0

struct Summary {
    1: required string summaryId,
    2: required i32 summaryCost
}

Summary getSummary(1: string summaryId);

void updateSummary(1: Summary summary);

现在假设有 5 个服务正在使用这个 1.0 总结合同。
在下一个版本中，我们添加了另一个对象，称为 summaryvalues 列表。

所以新合同看起来像

版本 - 2.0

struct Summary {
    1: required string summaryId,
    2: required i32 summaryCost,
    3: optional list<i32> summaryValues
}

Summary getSummary(1: string summaryId);

void updateSummary(1: Summary summary);

1. 因此，当填充下面的列表时，我们会保存 summaryValues aganist 的值列表 summaryId。
2. 当客户端将此列表发送为null 时，我们会删除为该“summaryId”保存的现有值。

现在，当使用 OLDER 版本的 thrift 合约（Version 1.0）的其他服务尝试调用 getSummary 和 updateSummary 时，会出现问题 .
旧客户端调用 updateSummary 的目的是为 summaryCost 设置另一个值。但是，由于此客户端不包含对象 summaryValues，它会将带有 summaryValues 为 null 的 Summary 对象发送到服务器。

这会导致服务器删除该 summaryValues 的所有现有值 summaryId。

有没有办法在节俭中处理这个问题？ isSet() 方法在这里不起作用，因为它们尝试执行简单的空值检查。
每次我们发布对现有对象进行修改的新客户端时，我们都必须强制升级其他服务器的客户端版本，即使更改与它们无关。

Answer 1

在您的version 2.0 中，updateSummary() 方法的合同已更改（即，现在它允许保存和删除汇总值）：

选项 1： 与其改变其行为，不如创建一个新方法（即updateSummaryV2()）并开始在最新版本的客户端中使用它，同时弃用旧版本。

这样，旧版本的客户端仍然使用正常的updateSummary()，而不会与新方法的约定和假设发生冲突。

---

选项 2： 添加一个包含 api 版本的可选字段，并将默认值设置为最新的 API 版本：

struct Summary {
    1: required string summaryId,
    2: required i32 summaryCost,
    3: optional list<i32> summaryValues
    4: optional i32 apiVersion = 2
}

这样，如果未设置apiVersion，您就知道请求来自旧客户端，对于未来的版本，您将知道客户端版本并做出相应的反应。

---

或者，您只能在提供空列表时删除记录，如果未设置列表，则不执行任何操作，以遵守之前的方法约定。

_{附带说明：即使不考虑交叉兼容性问题，让动作依赖于隐含的东西（这里是没有列表）通常也是有风险的。当此类操作依赖于显式标志时，它通常更安全（并且更易于使用和维护）。}