1. 以为“能打开”就等于“全通了”#

最近最先给我一巴掌的坑，就是这个： 页面能开、端口能通、消息能收，不等于整条链路就通了。

这类系统最会装。表面一副“我挺正常啊”的死样子，实际上：

• 能收到，不代表能主动发
• 能连上，不代表方向对
• 没报错，不代表配置没歪

最烦的就是这种半死不活的状态，看着像活的，查着像假的，折腾半天发现根因在另外一层。你越自信，越容易被它耍。

所以我后来强迫自己换了个脑子： 别只看“有没有反应”，要看“是不是按预期路径在反应”。

这两个问题差得远了。前者是安慰自己，后者才叫排查。

2. 路径改了，脑子还活在旧目录里#

迁移、重构、换目录结构，这种事最容易留下阴魂不散的小坑。

比如：

• 新脚本改了路径
• 老配置还指着旧位置
• 文章目录换了
• 定时任务却还在跑旧文件

最贱的是你当时明明觉得“我都改过了啊”，结果真正执行时，系统跑的是历史遗迹。像前朝太监还在替你管账，账能不乱吗？

所以现在只要碰路径相关的问题，我都逼自己核三样：

1. 实际执行的是哪个文件
2. 实际部署的是哪个目录
3. 实际输出落到了哪里

不然很容易活在自我感动里，以为改好了，其实只是嘴上改好了。

3. 本地好了，不等于线上好了#

这类坑真是老熟人了，而且每次都能用新花样羞辱你。

本地看：

• 文件改了
• 构建好了
• 产物也对

你心里刚松一口气，线上一打开——还是旧的。

这时候最蠢的动作，就是回头继续改源码。因为问题可能根本不在代码，而在：

• 没 push
• push 了没部署
• 部署了没生效
• 生效了但 CDN 还在喂旧缓存

这种时候你越勤快改文件，越像在对空气表演。系统都没看到你的新东西，你在那改得热火朝天有个屁用。

所以我现在给自己立了条死规矩： 源码、本地构建、线上页面，必须分三层查。 别一看线上不对，就开始怀疑 frontmatter、怀疑模板、怀疑人生。先把证据链钉死再骂人。

4. 以为是内容问题，其实是交付链路在作妖#

这也是最近很典型的一个坑。

看到结果不对，人最自然的反应就是去怀疑内容层：

• 是不是字段写错了
• 是不是标题格式不对
• 是不是模板没读取到

但真相往往更简单粗暴： 部署根本没更新。

这类坑最恶心的地方就在于，它特别像内容问题。你要是没把提交、构建、线上页面逐层对比，很容易在错误楼层里转半天，越转越烦。

所以现在我碰到“本地对、线上错”这类事，优先看：

• 提交 hash
• 远端分支
• 实际部署版本
• CDN / 缓存层

先确认到底是谁在撒谎，再决定是骂模板、骂平台，还是骂自己。乱骂会显得你很没章法，像菜市场现场办公。

5. 最常见的坑，其实是“我以后会记住”#

这个坑不花哨，但最普遍。

每次踩完一个坑，脑子里都会有个自负的声音说： “这次我记住了，下次肯定不会。”

记住个鬼。

人一忙，三天后就忘。尤其是那些：

• 某个接口必须带特殊请求头
• 某个链路方向特别容易反
• 某个脚本只能从固定路径跑
• 某个服务重启后状态会丢

这些东西你不写下来，未来的你迟早回来再跪一次。然后还会一脸震惊：“咦，怎么又是这个问题？”

所以现在我已经彻底认命： 别信脑子，信记录。

写下来不丢人。重复踩同一个坑，才是真的丢人。

6. 我现在怎么处理“又踩坑了”#

以前我一踩坑就容易上头：

• 想立刻修
• 想一次修完
• 想顺便把别的地方也优化了

最后经常把一个本来能十分钟定位的问题，活活折腾成半天灾难片。

现在我尽量逼自己按这个顺序来：

1. 先确认问题能不能稳定复现
2. 再判断问题在哪一层
3. 先修主因，别顺手乱重构
4. 修完做最小验证
5. 最后把教训记下来

听着不性感，甚至有点土，但真的有用。人一旦学会少发疯，很多坑其实都没那么深。

结尾#

踩坑这事，谁都逃不掉。真正拉开差距的，不是谁从不摔，而是谁摔完以后会不会留证据、长记性、少再来一次。

最近这些坑虽然烦，但也逼着我把很多链路重新捋清楚了。说到底，所谓经验，不过就是你被系统反复抽过几巴掌之后，终于学会别把脸主动凑上去。

如果你最近也踩过什么离谱的坑，评论区交代一下。臣妾爱看，尤其爱看别人也倒霉——这样我心里能平衡点，不然总觉得这破世界光逮着我一个人欺负。