知识卡片
接口演进要兼容旧调用方
服务分开部署后,提供方与调用方不会同时升级。直接把三参数接口改成四参数接口,会让尚未升级的调用方报错。接口演进要允许新旧版本暂时共存;把参数封装为对象可减少签名变动,但新增字段是否可选、默认值是否安全仍要单独核对。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 微服务架构:微服务化后系统架构要如何改造? · 查看原书依据
这是因为这个接口先上线后参数变更成了四个,但是调用方还未变更还是在调用三个参数的接口,那就肯定会报错了。所以服务接口的参数类型最好是封装类,这样如果增加参数就不必变更接口的签名,而只需要在类中添加字段就可以了。
参考来源
- 位置:《高并发系统设计40问》第22讲《微服务架构:微服务化后系统架构要如何改造?》(源文件:_epub-src/text/part0027_split_001.html)
- 结论依据:原文的三参数改四参数先发版事故说明调用双方升级不同步的风险,并建议用封装类扩展字段;末句是对这一方案适用边界的补充提醒。
- 原始内容:这是因为这个接口先上线后参数变更成了四个,但是调用方还未变更还是在调用三个参数的接口,那就肯定会报错了。所以服务接口的参数类型最好是封装类,这样如果增加参数就不必变更接口的签名,而只需要在类中添加字段就可以了。