接口版本演进的三种做法
加字段、改语义、删字段,三种改动的风险差得很远,处理方式也不该一样。
加字段最轻
新增可选字段对旧调用方无影响,只要默认值明确就能平滑上线。
默认值要与业务含义一致,否则老客户端读到空值会做错误判断。
改语义最险
字段名不变而含义变化,调用方无从察觉,错误往往在数据异常时才暴露。
这类改动应新增字段并行一段时间,确认无调用后再下线旧字段。
删字段要等
先标记废弃并观察调用量,归零之后再真正移除,避免硬切。
监控要看调用方维度,只统计总量容易漏掉低频但关键的调用。
版本的表达
版本放在路径上直观,放在头部更灵活,二者各有取舍。
无论哪种方式,兼容窗口都要写进文档,避免调用方猜。
回归的重点
老版本用例要保留在回归集里,新功能通过不代表老接口没坏。
灰度阶段对比新旧响应的字段差异,比只看错误率更能发现问题。
本文由考腾资讯网编辑部整理撰写,观点仅供参考;转载请注明来源与链接。