做了几年技术管理,我越来越觉得:很多团队写接口没问题,难的是把接口当资产管起来的习惯。前阵子一个技术负责人朋友吐槽:「这已经是第三次找不到接口了,每次都重新问一遍。」他们公司七八个业务系统、几十号研发,要做一次接口梳理,翻了一圈发现,没人能说清公司到底有多少个接口。
新来的同事要接老系统数据,先翻代码仓库,翻到一份三年前没人维护的 wiki;wiki 写的接口,代码早改了三版。问当初写接口的人,那人半年前离职了。最后只能在群里 @ 一圈,看谁还记得。
这类事反复发生的锅,不能只甩给哪个人粗心。几件很普遍的事叠在一起:没有统一的接口登记处;文档和代码早就脱节;老接口没人认领,像埋在生产环境里的哑弹;跨部门调接口靠「你认识谁」不靠「系统查得到」。
公司真正值钱的,往往不是写在简历上的系统,而是那些「只有离职同事才知道怎么调」的接口。