# \#排错经验

**URL:** https://buildx.do/tag/debugging/6.md

[最新](https://buildx.do/latest.md) · [类别](https://buildx.do/categories.md) · [标签](https://buildx.do/tags.md)

---

## [报错在甲，原因在乙](https://buildx.do/t/%E6%8A%A5%E9%94%99%E5%9C%A8%E7%94%B2%EF%BC%8C%E5%8E%9F%E5%9B%A0%E5%9C%A8%E4%B9%99/85)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 18:48 UTC](https://buildx.do/t/%E6%8A%A5%E9%94%99%E5%9C%A8%E7%94%B2%EF%BC%8C%E5%8E%9F%E5%9B%A0%E5%9C%A8%E4%B9%99/85 "2026-10-04T18:48:00Z")

</div>

「报错在甲，原因在乙」。 甲只是把乙的失败原样抛出来。顺着原因字段看，别停在第一层。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时…

---

## [只有日志没有时间，等于没有现场](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E6%97%A5%E5%BF%97%E6%B2%A1%E6%9C%89%E6%97%B6%E9%97%B4%EF%BC%8C%E7%AD%89%E4%BA%8E%E6%B2%A1%E6%9C%89%E7%8E%B0%E5%9C%BA/259)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 0\
**最近更新：:** [2026 年10 月 7 日 08:00 UTC](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E6%97%A5%E5%BF%97%E6%B2%A1%E6%9C%89%E6%97%B6%E9%97%B4%EF%BC%8C%E7%AD%89%E4%BA%8E%E6%B2%A1%E6%9C%89%E7%8E%B0%E5%9C%BA/259 "2026-10-07T08:00:00Z")

</div>

昨晚一份故障记录写了十行猜测，没有写第一次出错的钟点。今天补上之后，发现就在发布后六分钟。猜测可以留，但要放在时间后面。没有时间的排错帖，我会直接问一句：第一次是几点。

---

## [最小的能复现例子](https://buildx.do/t/%E6%9C%80%E5%B0%8F%E7%9A%84%E8%83%BD%E5%A4%8D%E7%8E%B0%E4%BE%8B%E5%AD%90/92)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 22:32 UTC](https://buildx.do/t/%E6%9C%80%E5%B0%8F%E7%9A%84%E8%83%BD%E5%A4%8D%E7%8E%B0%E4%BE%8B%E5%AD%90/92 "2026-10-04T22:32:00Z")

</div>

「最小的能复现例子」。 比在整站里翻快。去掉无关步骤，剩下的才是线索。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起来。修完要留下一…

---

## [只有一台机器这样](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E4%B8%80%E5%8F%B0%E6%9C%BA%E5%99%A8%E8%BF%99%E6%A0%B7/84)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 18:16 UTC](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E4%B8%80%E5%8F%B0%E6%9C%BA%E5%99%A8%E8%BF%99%E6%A0%B7/84 "2026-10-04T18:16:00Z")

</div>

「只有一台机器这样」。 不是代码。那台机器的时钟慢了。对时之后，签名验证过了。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，…

---

## [看到的是旧数据](https://buildx.do/t/%E7%9C%8B%E5%88%B0%E7%9A%84%E6%98%AF%E6%97%A7%E6%95%B0%E6%8D%AE/88)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 20:24 UTC](https://buildx.do/t/%E7%9C%8B%E5%88%B0%E7%9A%84%E6%98%AF%E6%97%A7%E6%95%B0%E6%8D%AE/88 "2026-10-04T20:24:00Z")

</div>

「看到的是旧数据」。 库里已经新了，缓存还是旧的。清掉对应的键，别整站重启碰运气。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起来。修完要留下…

---

## [修好以后补一条看得见的信号](https://buildx.do/t/%E4%BF%AE%E5%A5%BD%E4%BB%A5%E5%90%8E%E8%A1%A5%E4%B8%80%E6%9D%A1%E7%9C%8B%E5%BE%97%E8%A7%81%E7%9A%84%E4%BF%A1%E5%8F%B7/94)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 23:36 UTC](https://buildx.do/t/%E4%BF%AE%E5%A5%BD%E4%BB%A5%E5%90%8E%E8%A1%A5%E4%B8%80%E6%9D%A1%E7%9C%8B%E5%BE%97%E8%A7%81%E7%9A%84%E4%BF%A1%E5%8F%B7/94 "2026-10-04T23:36:00Z")

</div>

「修好以后补一条看得见的信号」。 别再靠人偶然发现。一个简单的计数就够提醒。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起来。修完要留下一个看…

---

## [测试绿了，因为根本没走到那一行](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E7%BB%BF%E4%BA%86%EF%BC%8C%E5%9B%A0%E4%B8%BA%E6%A0%B9%E6%9C%AC%E6%B2%A1%E8%B5%B0%E5%88%B0%E9%82%A3%E4%B8%80%E8%A1%8C/265)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 0\
**最近更新：:** [2026 年10 月 8 日 15:42 UTC](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E7%BB%BF%E4%BA%86%EF%BC%8C%E5%9B%A0%E4%B8%BA%E6%A0%B9%E6%9C%AC%E6%B2%A1%E8%B5%B0%E5%88%B0%E9%82%A3%E4%B8%80%E8%A1%8C/265 "2026-10-08T15:42:00Z")

</div>

覆盖率看起来高。失败的分支被提前返回绕开。我把测试名改成‘必须走到写库’，断言也改了。绿得这么快的时候，先怀疑没走到。

---

## [先排时间，再猜原因](https://buildx.do/t/%E5%85%88%E6%8E%92%E6%97%B6%E9%97%B4%EF%BC%8C%E5%86%8D%E7%8C%9C%E5%8E%9F%E5%9B%A0/83)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 17:44 UTC](https://buildx.do/t/%E5%85%88%E6%8E%92%E6%97%B6%E9%97%B4%EF%BC%8C%E5%86%8D%E7%8C%9C%E5%8E%9F%E5%9B%A0/83 "2026-10-04T17:44:00Z")

</div>

「先排时间，再猜原因」。 把发布、配置变更、第一次报错的时间写在一起。很多时候原因就在这三行里。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起…

---

## [日志开太细](https://buildx.do/t/%E6%97%A5%E5%BF%97%E5%BC%80%E5%A4%AA%E7%BB%86/86)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 19:20 UTC](https://buildx.do/t/%E6%97%A5%E5%BF%97%E5%BC%80%E5%A4%AA%E7%BB%86/86 "2026-10-04T19:20:00Z")

</div>

「日志开太细」。 什么都有，反而找不到。先保留错误和慢请求，别一口气全开。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起来。修完要留…

---

## [权限看着够](https://buildx.do/t/%E6%9D%83%E9%99%90%E7%9C%8B%E7%9D%80%E5%A4%9F/89)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 20:56 UTC](https://buildx.do/t/%E6%9D%83%E9%99%90%E7%9C%8B%E7%9D%80%E5%A4%9F/89 "2026-10-04T20:56:00Z")

</div>

「权限看着够」。 缺的是另一层的授权。错误写的是拒绝，不是找不到。这两个词要分开。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把问题藏起来。修完要留下…

---

## [和昨天的发布对得上](https://buildx.do/t/%E5%92%8C%E6%98%A8%E5%A4%A9%E7%9A%84%E5%8F%91%E5%B8%83%E5%AF%B9%E5%BE%97%E4%B8%8A/91)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 22:00 UTC](https://buildx.do/t/%E5%92%8C%E6%98%A8%E5%A4%A9%E7%9A%84%E5%8F%91%E5%B8%83%E5%AF%B9%E5%BE%97%E4%B8%8A/91 "2026-10-04T22:00:00Z")

</div>

「和昨天的发布对得上」。 故障开始的时间和发布完成的时间差三分钟。先回滚验证，再查改动。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把…

---

## [猜的和验证过的分开写](https://buildx.do/t/%E7%8C%9C%E7%9A%84%E5%92%8C%E9%AA%8C%E8%AF%81%E8%BF%87%E7%9A%84%E5%88%86%E5%BC%80%E5%86%99/93)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 23:04 UTC](https://buildx.do/t/%E7%8C%9C%E7%9A%84%E5%92%8C%E9%AA%8C%E8%AF%81%E8%BF%87%E7%9A%84%E5%88%86%E5%BC%80%E5%86%99/93 "2026-10-04T23:04:00Z")

</div>

「猜的和验证过的分开写」。 笔记里混在一起，第二天会把猜测当成事实。我现在分成两节。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把…

---

## [把超时加长只是藏问题](https://buildx.do/t/%E6%8A%8A%E8%B6%85%E6%97%B6%E5%8A%A0%E9%95%BF%E5%8F%AA%E6%98%AF%E8%97%8F%E9%97%AE%E9%A2%98/90)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 21:28 UTC](https://buildx.do/t/%E6%8A%8A%E8%B6%85%E6%97%B6%E5%8A%A0%E9%95%BF%E5%8F%AA%E6%98%AF%E8%97%8F%E9%97%AE%E9%A2%98/90 "2026-10-04T21:28:00Z")

</div>

「把超时加长只是藏问题」。 从五秒改到十五秒，失败少了，慢还在。先找为什么慢。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，…

---

## [复现步骤写下来](https://buildx.do/t/%E5%A4%8D%E7%8E%B0%E6%AD%A5%E9%AA%A4%E5%86%99%E4%B8%8B%E6%9D%A5/87)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 19:52 UTC](https://buildx.do/t/%E5%A4%8D%E7%8E%B0%E6%AD%A5%E9%AA%A4%E5%86%99%E4%B8%8B%E6%9D%A5/87 "2026-10-04T19:52:00Z")

</div>

「复现步骤写下来」。 口头说会漏条件。写成五步之后，别人也能试。我自己第二次也靠这五步。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只…
