API开发者呼吁：技术评论应回归客观本位

文章配图，仅供参考

　　冷眼。监控大屏左下角那条绿色曲线，十七点零三分抖了一下，幅度不到两个像素，连告警都没触发，我就多看了一眼，后来知道是DBA在隔壁机房手动切了个只读副本的连接池。没人关心它，但它确实在抖。

　　API开发者呼吁：技术评论应回归客观本位。这个标题我敢打包票，不是我起的，是技术传播组实习生写的初稿，改了三版，最后定稿时把“呼吁”前加了“沉痛”，我把“沉痛”划掉了。沉什么痛？接口挂了？没挂。下游调用方报错？报了，但错误日志里明明白白写着“上游响应超时（3.2s），非服务端异常”。可第二天某垂直媒体公众号推文标题是《某大厂API设计反模式引发连锁雪崩》，配图是我们在灰度环境里压测时随手画的链路草图，还给虚线框打了马赛克——马赛克盖住的恰恰是网关超时配置项。

　　咖啡杯上印的公司logo已经磨花了，只剩右下角半个“云”字，今天早上倒水时顺手擦了两下，没擦干净。谁去倒的水？测试小张。她端着杯子路过我工位时说了句“你那个/v2/order/list接口，前端说下拉刷新老卡”，我回她“你让他清下缓存”，她说“清了”，我又说“那你让他看Network面板”，她点头走了，再没回来。这事就断在这儿了。我没再问，她也没再提。

　　优胜劣汰是优点。不是我说的，是去年十一月复盘会上，架构组老李甩出一份调用量Top50接口清单，里面三个已被归档，两个正在迁移到新协议，还有一个还在扛着日均三百七十二次调用——就靠一个兜底降级策略活着。没人表扬它，也没人骂它，它就在那儿。可同样的逻辑，换到技术评论场域，怎么就成了“必须一棒子打死才能显专业”？

　　oncall手机震了一下。凌晨两点十七分，不是告警，是钉钉消息提示音——产品总监在群聊里@所有人：“大家看看这篇分析，很有启发性”，然后贴出链接。我划开看了三行，关掉。那篇文章讲我们刚上线的聚合查询接口“过度抽象导致不可观测”，可它连OpenTracing采样率都没提，反而大段复述我们Wiki里写的“推荐分页粒度”。我信不信它？我说不准。但我信我们SRE同事上周五下班前默默把/trace/export的限流从五十QPS调到了两百——没人通知我，我在kibana里翻慢日志时偶然看见的。

　　跟DBA吵过两次。第一次是他坚持要把所有write接口的事务隔离级别提到Serializable，理由是“避免幻读”，我说“你真觉得订单支付会因为幻读崩？”他拍桌子说“我负责数据一致性”。第二次是我问他为啥线上库binlog_format还是MIXED，他笑：“你们API又不读binlog，管它干啥？”——结果三个月后，风控那边自己搭Flink作业去消费binlog，字段类型解析全乱套。这事儿最后没上复盘会，因为法务说“内部系统对接，不构成SLA违约”。

　　KPI这事得提一句：今年我的OKR里有一条是“API可观测性覆盖率≥85%”，目前卡在79%，差的那16%全在历史遗留的SOAP接口里。SOAP！去年还活着！运维说“客户合同没到期”，法务说“替换需重新过等保”，而我每天盯着Prometheus里那个永远低于90%的指标发呆。你说技术评论该不该回归客观本位？该。可当“客观”变成KPI的一部分，它就开始打滑了。

　　有个失败案例我得记下来：六月上线的履约回调通知，用了WebSocket长连推事件，结果安卓端兼容性崩得像被雷劈过——不是协议问题，是厂商定制ROM把后台service杀太狠。我们改成HTTP轮询，延迟从毫秒级变成十八毫秒，测试组验收时嘀咕“不如之前快”，PM立刻让写个“性能妥协说明”。说明写了，但没人发出去。因为三天后另一个业务线拿同样方案跑通了，他们叫它“柔性推送”。名字一换，缺陷变特性。

　　我早先以为技术评论的水分主要来自“不懂装懂”，后来发现更麻烦的是“懂一半就下判决”。比如有人揪着我们response里带了个X-Request-ID头说“泄露内部结构”，可我们header里还有X-Foo-Env和X-Biz-Code——后者才是真敏感信息，评论文章却只字未提。为什么？因为它不够“酷”。ID头好讲，“唯一标识”“链路追踪”“可观测基石”，一套词堆上去显得高屋建瓴；而X-Biz-Code里藏的是渠道编码规则，得翻三年前的CRM文档，谁有空？

　　下周二我要去跟前端同步v3订单API的error code规范。他们新来了个实习生，简历写着“熟悉RESTful最佳实践”，我打算让她先读一遍RFC 7807，再让她看我们当前code映射表里第27、33、41条是怎么偏离它的——但不许她写成文章发出来。真要发，至少等我先把那个灰度开关推完。推完那天，我大概会记得给咖啡杯换个新的，logo得是完整的。

（编辑：站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!