无尘阁日记

无尘阁日记

两个接口,和我蔓延出去的那几百个地方
silcano

11 月 18 日上午十点半,我在一个三个人的项目群里,被两句话钉在原地。

「我没说改其他啊。」

「几百个地方,你敢动啊。」

两分钟前,我刚在群里说:这一批接口我都会统一,入参和返回都统一,需要你也按这个改,不然老的可能就用不了了。

我以为我在解决问题。他的反应是我在制造问题。

接下来的二十分钟,谁也没说服谁。最后是他先松口:「你愿意全系统改,我配合就行,替换字段而已,只要你愿意。」而我说的是:「行吧。你弄完,更新上去。」「我先不动了。」

那天上午我关掉窗口的时候,心里是有点委屈的。现在回头看,委屈是那天最不该有的情绪。

一、事情本身,其实很小

后台的报告模板里有一个「总部公司」字段。这个字段历史上没有被约定过命名,于是同一个东西在各处长出了四种写法:

headOfficeUid headofficeUid headOfficeUuid headOfficeUuids

大小写不同,单复数也不同。

那天他报了一个 bug:保存成功,但读不回来。我查了一遍,原因很清楚——前端 save-company 提交的是 headofficeUid[0]、headofficeUid[1](小写 o),后端只按 headOfficeUuid / headOfficeUuids 做大小写敏感匹配,取到 null,被当成「传空」,先删后插 0 条,于是 company-list 回读永远是空数组。表现就是「保存成功但没保存上」。

前端 save-company 实际提交的表单数据

他发来的抓包:headofficeUid[0]、headofficeUid[1],小写 o

company-list 返回空数组

对应的响应:headOfficeUuids: [],写进去了,也丢了

我把根因整理成一段话发给他,末尾说「我已经按你传的这个字段改了」。然后,我多写了一句话:

「同样的问题在『添加/编辑模板』也存在(那条链路也读 headOfficeUuids)。」

就是这句「顺便提一句」,把后面的一切都点着了。

二、把对话一句一句摊开

下面这段是我从记录里逐条整理出来的,只删了寒暄,没有增删意思。

时间对话
09:58他:两张抓包截图,「没保存上」。
10:23我:一段根因分析,末尾加了一句「添加/编辑模板也有同样问题」。
10:26他:一张文档截图,「headofficeUid headOfficeUuids 这种最好统一成一个」。
10:27我:「这个是我和之前负责的同事没有约定成一个,全系统应该会有很多」「统一的话没问题,不过可能就得涉及较大面的测试」。
10:28他:「是的,有很多」→「我说你这两个接口处理的时候可以用一个」。
10:28我:「按你的来」「也就是已经统一为:headofficeUid」。
10:29他:把四种写法列了一遍,「这几个系统中都有」。
10:29我:「你需求是啥?是全站统一,还是仅仅这几个报告接口」。
10:30我:「仅仅是报告接口,我已经统一了,我这会再检查下,将这次涉及的几个报告/说明接口统一为 headofficeUid」。
10:34我:贴出文档里 12.5、12.6 两个接口,「这两接口,不仅仅影响报告说明,还影响老的底稿分配。确定都改对吧」。
10:36他:「我没说改其他啊」「几百个地方,你敢动啊」。
10:38我:「我发你的是这一次涉及的接口」「那你说的统一,我没搞明白,具体是哪几个接口统一呢?」
10:38他:连发四张截图,没有文字。
10:39我:「你把接口标记下,免得我改错了,很麻烦」。
10:39他:「不是,你为啥喜欢扩展问题,发散问题,延伸问题啊」。
10:40我:「主要是没理解,你指的两个接口是哪两个。我回答以为是这次全部」。
10:41他:「我截图是按照你文档截图的,你给我发的错误信息,是前端用了错误的字段」。
10:41我:「你说的没毛病。我没对应上,具体哪两个。」「是我的问题哈。理解不到位。抱歉哦。」
10:42他:「这都是你自己发的,我一一回复了,怎么到你这儿,一下子扩展出这么多东西」。
10:44他:「不过,你愿意全系统改,我配合就行,我希望系统更好……替换字段而已,只要你愿意」。

三、他要的东西,其实非常小

问题的答案一直摆在我自己发出去的那张表里。文档第 12 节「现状盘点」列了八个接口,标着哪些需改、哪些不涉及、哪个已符合:

文档第12节 现状盘点

12.6 12.7 12.8 三行

他要的是相邻的这两行:

  • 12.7 GET api/report-template-allocate/company-list 企业字段 headOfficeUuids 位置:返回 需改
  • 12.8 POST api/report-template-allocate/save-company 企业字段 headOfficeUid 位置:入参 已符合

一个写,一个读,同一份数据,两个名字。他说「你这两个接口处理的时候可以用一个」,就是这个意思——别一个单数、一个复数,读和写用同一个名字就行。

而我把它翻译成了:这一批里所有出现 headOffice* 的地方,甚至全站,都统一。

他不是没说明白。他说了三遍。「这种最好统一成一个」「我说你这两个接口」「我没说改其他啊」。

四、所以这是我的问题

不是他表达不清,也不是他脾气差。三件事我都没做到:

第一,我没认真看他的截图。那张图里同时出现了 headOfficeUid 和 headOfficeUuids,一行一个,那是全场唯一的线索。我看到了字,没看到差别。

第二,我没认真读他的话。「你这两个接口」里的「这两个」是特指。我把它当成了泛指,自动补成「你说的这一类接口」。

第三,我把「统一」这个词,补全成了我脑子里最大的那个版本。本次全部新增和修改接口,再往外一点,全站。

这三件事加起来,就是心浮气躁。心浮气躁不是脾气,是不肯在别人的一句话上多停三秒。

五、往深处挖:我到底在干什么

1. 我以为自己在听,其实在等发言

回看那二十分钟,我没有一次是听完再想的。他说「这两个接口可以用一个」,我脑子里同时在跑的是:那我这批次涉及的还有哪几个、底稿分配要不要动、工作站是不是也得跟着改。

倾听有四层:假装在听、选择性听、专注地听、听懂之后才回应。我那天停在第二层——只听见了和我手上活有关的部分,其余全被过滤掉了。

更准确地说,我不是在听他说什么,我是在他的话里找我能接上的那个接口。

2. 我为什么总把范围放大

把两个接口改成两百个接口,看起来是负责,其实是一种回避。

精准地改两个地方,意味着我要承担一个判断:「我确认这就是全部,其他不用动。」这个判断是要负责的——万一漏了,是我的错。

而「全都统一」,我就不用判断了。反正都改了,就不会有漏。看起来很彻底,其实是把判断的责任摊薄掉,摊到「统一」这个动作本身上去。

所以蔓延不是勤奋,是回避判断。范围越大,我越安全——这个逻辑在心理上成立,在工程上完全不成立,因为几百个调用方会一起塌。

3. 被指出问题的那一刻,我在自证,不在核对

「我发你的是这一次涉及的接口。」

这句话对解决问题毫无贡献。它唯一的功能是:证明我没做错。

人在被指出问题时,第一反应通常是防守,这很正常。但我把防守伪装成了沟通——用一句听起来像澄清、实际是辩解的话,把技术讨论悄悄换成了「我有没有错」的辩论。

他后来说「这句话说的哪里不对吗」。他问的是事实,我答的是立场。我们那时候已经不在同一个对话里了。

4. 我把「方案被否」听成了「我被否」

「几百个地方,你敢动啊。」这句话在事实层面是对的。但我听到的是另一层:你不行,你想不清楚,你在添乱。

一旦进入这个频道,后面的所有交流都会变形。他再说什么,我都先翻译成对我的评价,再去回应评价,而不是回应问题。这就是为什么我连续三次问「具体是哪两个」——我不是在确认需求,我是在找一个能证明我没错的答案。

5. 撤退:最省力,也最伤人的反击

「行吧。你弄完,更新上去。」「我先不动了。」

这两句话看上去是服从,其实是弃权。而且是一种很体面的弃权——我没有吵,我甚至道了歉(「是我的问题哈。理解不到位。抱歉哦。」),然后把手一摊。

心理学上这叫被动攻击:不正面冲突,用退出、拖延、示弱来表达不满。它比吵架更消耗对方,因为对方连反驳的落点都没有。他后来说「这都是你自己发的,我一一回复了,怎么到你这儿,一下子扩展出这么多东西」——他不是在骂我,他是在说他累了。

沟通遇到障碍就撤退,看起来是止损,其实是我第二次放弃了理解对方的机会。第一次是我没听,第二次是我不听了。

6. 心浮气躁的真实来源

那天上午我手上同时压着模板配置、底稿分配、公司列表回读、字段命名统一四件事,每一件都只做到一半。带宽被占满之后,人会本能地选择最省思考的路径——而「全都统一」恰恰是最省思考的那个:不用判断、不用取舍、不用承担「我确认只有这两处」的责任。

所以心浮气躁不是性格缺陷,是负载过高的症状。症状提醒我的应该是「停一下」,我做的却是「加速」。

7. 代价

他多花了二十分钟一句一句回我;我多花了二十分钟自我辩护;一个十分钟能结束的对话,变成了二十分钟的对抗。而真正该改的那两个接口,那天上午一行代码都没动。

六、下次,我想这样做

先复述,再回应。听完先回一句:「你的意思是 12.7 和 12.8 这两个接口,字段统一成一个,对吗?」一句话,不丢人,能省掉后面所有拉扯。

不懂就问具体,不要问范围。「具体是哪几个接口」这句话,应该出现在第一次回复里,而不是第十轮。

不给自己加戏。对方没提的地方,最多问一句「要不要一起改」,他说不,就不改。要改全站,另开一单,另算成本。

被批评时,先问事实。「你说的蔓延,具体指哪一句?」而不是先解释。解释是给自己的,核对是给问题的。

想撤退的时候,换成一句明确的收尾。不是「行吧,你弄完」,而是「我先只改这两个,其他不动,剩下的等你有空我们再定」。

七、最后

那天最后是他先给的台阶。而正确的收尾,本该是我说的那句:

「我先把 12.7 和 12.8 这一对统一,其他不动。全站统一我另开一单,等你有空我们再定。」

他把话说得很小,我把话说得很大。他一直在收窄,我一直在铺开。这不是技术判断的差距,是愿不愿意在别人的一句话上停三秒的差距。

听人把话说完,是最便宜、也最难的能力。那天我没做到,所以写下来。

关于作者 · 江天(楠哥)
AI 实战导师 / 企业 AI 落地顾问 / 智能体工程师,17 年跨界、15,000+ 小时 AI 实操、20+ 套已交付工作流。
标签