# 多返回了一个内部字段

**URL:** <https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40>\
**Category:** 开源藏珍\
**Tags:** 源码实践\
**Created:** [2026 年10 月 3 日 18:18 UTC](https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40 "2026-10-03T18:18:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![linxiao](https://buildx.do/letter_avatar_proxy/v4/letter/l/d78d45/32.png) [@linxiao](https://buildx.do/u/linxiao)\
**Post date:** [2026 年10 月 3 日 18:18 UTC](https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40/1 "2026-10-03T18:18:00Z")

</div>

调用方只需要名称和状态。响应里多了一个内部编号，是给后台任务用的，不该出现在对外结果里。

内部编号一旦被外面依赖，以后就删不掉。我在被依赖之前把它从响应里拿掉了。

加了一条测试，断言响应字段只有约定的那几个。多一个字段，测试就失败。

内部任务仍用编号，但走内部方法，不从这条对外响应里读。两边分开之后，改对外字段不会弄坏任务。

说明里补了响应示例。示例和测试用同一组字段，避免文档又把内部编号写回去。

发布后看了真实响应，内部编号不再出现。旧的调用方没有用过这个字段，所以没有兼容问题。

读一段不熟的实现，我先写调用顺序，再进文件。测试名字和断言放在注释前面，因为注释会过期，测试红了会有人看见。函数名承诺的事如果包不住函数体，就拆开或改名，不要靠调用方记得副作用。改完用这条路径的成功、失败、缺参数各走一遍。

这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。

复查「多返回了一个内部字段」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。读代码时我按固定顺序，避免在文件之间跳丢。先写六行调用：入口、校验、查询或计算、副作用、返回、失败时怎样。再看测试名字和断言，最后才看注释。注释和断言冲突时，以断言为准，然后把注释改掉。函数名如果包不住副作用，就拆成两个名字，让调用处自己选择。改完用成功、失败、缺参数三条输入各走一遍。三条结果必须不同。相同就说明失败被吞掉了，或者缺参数也被当成了成功。把这六行和三条结果留在提交说明里，后来的人不用再把调用栈走一遍。

操作顺序。1. 用六行写下入口、校验、查询、副作用、返回、失败时的结果。2. 打开对应测试，先读名字，再读断言。3. 名字、断言、注释三者不一致时，以断言为准改另外两处。4. 如果函数还做了名字里没有的事，拆出去或改名。5. 用成功、失败、缺参数三条输入各打一次，三条结果必须不同。6. 把六行调用和三条结果写进提交说明。后来的人按这六行读，不必再把文件跳一遍。

---

<div class="post-metadata">

**Author:** ![suyanran](https://buildx.do/letter_avatar_proxy/v4/letter/s/b2d939/32.png) [@suyanran](https://buildx.do/u/suyanran)\
**Post date:** [2026 年10 月 3 日 19:38 UTC](https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40/2 "2026-10-03T19:38:00Z")

</div>

响应里多出来的内部编号，用一条断言卡住。不然下次又会漏出去。
