一次天真的重命名.

字段叫错了名字,改过来是理所当然的事。但这个字段已经被小程序读了半年,也被两个脚本依赖着。

改动本身花了三分钟,善后花了两天。这两天里我一直在想:如果一开始就把它当成契约,会怎么做?

扩展,而不是替换.

答案很朴素:先加上新字段,让两者共存;让下游逐个迁移;确认没有人再读旧字段,才把它删掉。

慢,但每一步都是可回退的。而一次性的重命名,只有一个瞬间是安全的——就是没人在用它的时候。

下周.

把这次的教训写进接口文档,顺便给旧字段加上一段注释,说明它为什么还活着。