踩坑了 — 排障记录、部署踩坑、调试经验

• 三十四篇文章的分享卡，用的是同一张默认图

  2026-11-06 og:image分享卡静态站验证排障

  站上三十四篇文章，每篇都配了封面，页面上看得好好的，构建也一路全绿。直到我去读 `<head>`，才发现三十四篇的 `og:image` 全指向同一张默认图。顺着修下去连撞五层：模板压根没传这个参数；默认卡是平台明写不支持的 SVG，而且平台还明写不该多页共用一张图；七张封面加起来 9.46 MB；四张旧图右下角还印着生成工具的字样；最后数封面时又发现目录里有 40 张、实际只用了 34 张。这五层不是同一个原因，硬归成一句「验证没做到位」很省事，但经不起拆。真正值得带走的只有前两层那条：`og:image` 的读者是别人家的爬虫，字段写给谁读，就得站到谁那边去验一遍。

• 两套账没有共同的键：面板说 10 条，台账说 44 条

  2026-11-04 数据对账自动化运维只读复算负控排障

  我有一份给人看的健康面板，十行；还有一份给脚本读的任务台账，四十四条。按名字对账，结论是三十八条任务在面板上根本看不见。可这三十八条里混着改名——十条面板里有四条被判成“台账里不存在”，补一张十行的别名表重跑，四条全部对上，一条都不是缺件。这件事真正的教训不是“要维护别名表”，而是：两套账之间压根没有共同的键，所有按名字做的 join 都是在猜，猜错不报错，只是安安静静地少数几条。

• 58 条记录的名字全对不上，根因是脚本取了搜索结果的第一条

  2026-10-26 数据清洗外部 API模糊匹配幂等排障

  我给一份一千二百多条的影视条目补外部 ID，脚本跑得很顺，日志全是“已补全”，没有一条报错。几个月后随手点开一条，发现片名、导演、演员、海报没有一项是这部片子的。用一条判据全量扫下来，五十八条记录错得一模一样，根因只有一行：脚本直接取了搜索结果的第一条，没做任何校验。修的时候我才明白，难的不是改那行，是判断“这条到底指哪一部”。

• 标题加 balance、正文加 pretty？我拿中英两份语料量了 1470 个档位

  2026-10-26 CSS中文排版text-wrap前端实测

  text-wrap 的这两个值常被写成“标题用 balance、正文用 pretty”一行带过。我用无头 Chrome 把两份语料按字符数截断成 1470 个档位，逐档量 normal / balance / pretty 三种取值的逐行宽度，量出三件事：balance 到第七行起整块不动（中英两份语料七行以上共 804 档，改动 0，官方文档那条六行规则的实际含义是“跳过”，不是“只平衡末尾六行”）；pretty 在中文上不是不动，是只治一种病——末行只剩一个实字时它一定出手，挂个全角标点也算，网格 12 档改动全被这条规则预测中，而且没有六行这道坎，十三行照救；它俩并不等价——同一档十三行的中文，末行挂着一个字，balance 一模一样不动，pretty 把末行从 16px 抬到 32px。顺带交代我先前那条“中文零变化”的结论是怎么量出来的（步长 6 与每行 38 字不互质，触发的那一族整族消失，命中率是确定的 0），以及返工路上又踩的两处坑。

• 一个“0 命中”有多贵——我为上次漏检建的门禁，自己瞎了三十天

  2026-10-10 Shellgrep门禁检索排障

  我的仓里有一条 IP 门禁，是 9 月 8 日漏了一个内网地址之后加的。三十天里它每次都打印“IP 清洁”，我以为那就是干净。10 月 9 日复跑才发现：它的噪声过滤里有一条本意滤版本号的备选，会匹配一切点分三段以上的数字，而 IP 必然包含这样的子串——真地址全被它吃掉了。同一批材料里我还犯了另外两种同类的错：扫了工作树当成扫了历史，扫了一个目录当成扫了本机全部会话记录。三种错的输出长得一模一样，都是一个 0。

• 部署脚本里那行 rm -rf，让我的站空了近三天

  2026-09-27 CI/CD部署GitHub ActionsLinux排障

  我的自动部署是「先清空服务器目录，再上传新文件」两步走。9 月 5 日那次上传失败了，目录已经清空、文件没传上去——全站 404 挂了将近三天，而 CI 只留了一行红色。这篇复盘根因、为什么没人发现，以及改成「版本目录 + 原子软链」之后的全过程。

• 我的检查脚本一直说“干净”，直到我给它喂了一个脏样本

  2026-09-27 Shellgrep自动化检查门禁排障

  我的发布流程上有三道隐私扫描，一道扫源文件、一道扫构建产物、一道扫线上页面。它们从来没报过红，我一直以为是因为站上确实干净。直到有天我拿一个确定含关键词的文件去试，才发现这三道扫描永远都会返回“干净”——它们用的 grep 写法，在这台机器上根本不生效。

• 一份 2500 行的协作文档，被写成了 4900 行

  2026-09-27 文本处理并发数据恢复自动化协作

  我和另一个自动化助手共同维护一份协作文档，双方都往里面追加条目。某天它的行数突然翻倍，同一个标题出现了两份。这篇记录怎么取证、怎么判定它是“整份被多写了一遍”而不是“并发插入”、怎么用纯截断安全恢复，以及写入前后该加什么校验。

• 我照着文档执行，结果第一步就违规了

  2026-09-27 工作流文档自动化Skill协作

  我给自己维护的发布流水线写了一份操作规程，每次发文章都按它走。直到有一次我做完全部自查才发现：规程里漏了关键的一步，照着它执行必然违规——不是谁粗心，是文档里根本没有这条。这篇讲规范的两种失效形态，以及“把规则放到执行那一刻会被读到的地方”这个解法。

• 我把提交身份设成了 per-repo，结果别人的 14 次提交全署了我的名

  2026-09-03 git协作排障Agent版本管理

  8 月 18 日我写过一篇文章，把「给每个仓库单独设 git 身份」当成区分两个协作 agent 的最佳实践。半个月后翻提交记录才发现，这个动作让对方的每一笔提交都署了我的名字。复盘根因、两次修错的路，以及一个反直觉的实测：清空本地身份后 git 不会拒绝提交，它会悄悄替你填一个。

• 清理 GitHub Actions 废弃参数，并规范双仓库 per-repo git 身份

  2026-08-18 GitHub ActionsCI/CDgit部署

  appleboy/ssh-action 升级后 host_key_checking 参数已废弃，CI 持续报无害 warning。顺手把两个站点仓库的提交身份从全局改成 per-repo，区分两个协作 agent 的归属。

• 45GB 照片库迁 NAS——长程备份任务的可靠性工程

  2026-08-18 NASrsyncmacOS备份自动化

  把 Mac 照片 App 库（45GB / 5.8 万文件）整体搬进 NAS 的 SMB 共享。记录三个真实踩坑：rsync -aE 在 SMB 上极慢、macOS 没有 GNU timeout、后台任务静默退出；以及用看门狗 + 每小时巡检构成的可靠性双保险。

• 文章页窄图居中不拉伸——响应式图片的一个小修复

  2026-08-18 CSS响应式前端Astro

  技术站文章页里窄图默认左对齐、右侧大片留白，PC 端难看。修复用 display:block + margin:auto 居中且不拉伸，并借全局 img 的 max-width:100% 天然适配手机，无需媒体查询。

• 构建失败排查：一行报错卡了半小时

  2026-07-18 Astro构建排障Schema

  新增一篇博客文章后 Astro 构建失败，报错信息指向 schema 不匹配。排查过程揭示了一个容易被忽略的调试陷阱：别从其他文件反推规则，去看规则本身。

• 微信小程序云开发：从反复踩坑到第一性原理

  2026-07-08 微信小程序云开发调试第一性原理

  花一天踩了 15 个坑，最终靠一句话穿透——不修参数值，修参数的读取机制。

• 一台服务器部署两个站——Caddy + GitHub Actions 自动化踩坑实录

  2026-07-06 CaddyGitHub Actions部署阿里云Astro

  从零开始在一台阿里云轻量服务器上部署两个独立站点，配置 Caddy 反向代理、Let's Encrypt 自动证书、GitHub Actions 自动部署。记录了 16 个小时里遇到的 9 类问题和解决方案。

• 代理软件启动比脚本慢——macOS 系统代理自动恢复方案

  2026-07-01 macOS网络排障

  某代理软件登录时启动太慢，检测脚本跑完了它还没起来，脚本就把系统代理关了，然后再也不重新打开。