踩坑记录

开发过程中真正卡住过人的问题，一个问题一篇。

目的不是记录所有 bug——改完就完的常规 bug 不进这里。这一栏收的是那些「事后看一行就能说清、事发时却花了大半天」的问题，写下来是为了让下一个人不必再走一遍同样的弯路。

什么该收进来

满足任意一条：

反过来，这些不必收：能靠报错信息直接定位的、只影响一次的环境问题、纯粹的手误。

顺序固定，方便扫读：

段落	要回答的问题
现象	用户/开发者看到的是什么，不掺任何推测
根因	一句话能说清的那一行代码或那一个假设
为什么是这个表现	从根因推到现象的完整链条，尤其是被放大的环节
排查中走过的弯路	哪些看起来最像的嫌疑其实不成立，这段往往比根因更值钱
修复	改了什么，怎么验证的
可推广的规则	脱离本次上下文仍然成立的那几条

「排查中走过的弯路」不要省。下一个人遇到类似现象时，最先想到的多半也是那几个被排除掉的方向。