老接口要下掉先给过渡期，替代路径得跟着一起说清
一个对外接口用了好些年，里头几处写法早没人愿意再维护，团队打算下个季度把它停掉。通知发出去没两天，对接方就找过来：他们那套系统还在老路上跑，一时半会儿挪不动，问能不能晚些再停。一、先把谁还在用这条老路查清
从调用记录里把还在走老接口的来源一处处列出来，哪个对接方、哪套系统、一天大概走多少回。别凭印象说应该没什么人用了，记录翻出来常常比想的多，还常冒出几个早没人提起的老系统。季度盘点把改动回数和问过来的条数并排看，涨得快说明带进来的东西多，问得多说明哪处没交代清，两样凑一起才有方向。
列的时候把间接的也算上。有的对接方自己早换了，可他下游还留着一处在调；通知只发到直接对接的那一层，下面那一截就没人知道，停的那天才一起冒出来。每回升完的结论记回表里，只写半句的人过两个月也想不起当时为什么这么定，后来的人更只能照着猜。
二、过渡期按挪动的难度来定
给多久不能一刀切，得看还在用的那几处各要改多少、各自多久能排上一次发版。有的只是换个地址，一两天就完；有的牵着自家的单据结构，得等一个完整窗口。按慢的那处定，别按快的。
过渡期里老路照常开着，但要把到哪天为止写明白，顺带写清那之后会怎么对待还走过来的请求。含糊说一句尽快迁移，各家都会按自己的理解排，末了多半还得再催一轮。归档目录按改动类型分开，找的人想的是那一回属于大改还是小补，不是文件存在哪个文件夹，顺着念头排才找得快。
三、替代路径要连例子一起给
光说改用哪条新路不够，得把常见几种用法一条条摆出来：原来这么传的现在怎么写、原来一次拿一批的如今分几步、返回里的字段改了哪几个名字。对接方照着例子改，比自己对着说明猜省太多来回。
例子里把不一样的地方标出来。新旧两条路看着像，偏偏某处默认值反了、某个字段从必给变成可能没有，这类地方不点明，改完一试结果不对，两边又得从头对一遍。复盘会定在收工后隔一天，当天大家还忙着收尾，说不出几句实在话，隔一晚反而能把卡住的地方讲清。
四、两条路并跑时留意口径
过渡期里新老两路同时开着，同一件事从哪条进来，落下去的结果应当是一回事。有的逻辑只在老路上补过一处判断，新路忘了带，同一个请求走两条路得到两种答案，查起来格外绕。
并跑这段留一份对照：挑几组同样的输入，两路各跑一遍，把结果比一比。比得上的记一笔，比不上的趁人还在、两路都开着的时候改掉；等老路一停，再想复现当时的差异就难了。把前后两份对照并排存着，别只留后面那一份，过些日子有人问起差在哪儿，光看新的那份答不上来。
五、临近截止按名单逐个确认
到期前一阵，照开头那张名单一家家问过去：改完了没、试过没、还有哪处卡着。别只发一封群发的提醒就算数，回得来的往往只有本来就改好的那几家，没回的恰恰是要紧的。
确有一时挪不动的，单独记一条：为什么、谁点的头、宽到哪天、这段里由谁盯着。宽限写得明白，才不至于变成谁都默认可以一直拖；也免得真到停的那天，临时又有人来说情，进退都难。培训材料里放一张当时排期的原样，比重新画一张顺手的示意图管用，哪里挤、哪里空，看一眼就明白。
六、停完之后留一段可回看的记录
老路关掉那天，把名单、各家确认的时间、宽限过的几笔、并跑时的对照结论归成一份存着。往后有人翻出一段旧调用问是怎么回事，看这份就知道当时的来龙去脉。
关掉也别急着把相关代码一次抹净，先留一段只读的痕迹，标明哪天停的、替代的是哪条。过些日子若还有零星请求摸过来，凭这几行就能回清楚，不用把当年经手的人重新找回来回忆。谁负责把结论抄进台账写进值班表，没名字的记录过两个月就没人认得是谁顺手写的那一行。
老接口停不下来，很少是对接方不肯配合，多半是没先把谁还在用、各自要挪多久摆到同一张纸上。查名单、定过渡、给例子、比口径、逐个确认、留记录，六件事走顺了，停的那天就安安静静；缺了哪件，都容易变成截止日前后一轮接一轮的临时商量。 很多点我之前都没想到，楼主一提醒才恍然大悟，收获很大。 感谢楼主带来这么好的内容，在论坛里能学到东西真的很开心。 已经推荐给朋友来看了，好东西就应该一起分享一起学习。 感谢楼主无私分享经验，少走了很多弯路，对我们帮助特别大。 看完之后深有感触，有些话真的说到心坎里了，很有共鸣。
页:
[1]