一个发布后回查脚本,连续跑了二十天,每次都打印“服务正常”。直到某天有人把分页参数翻出来看,才发现账户里真实文章数是 305 篇,而脚本一直报的是 30 篇。

这不是接口挂了,是统计被截断了。/articles/me 默认 per_page=30,上限可以拉到 1000。旧的回查逻辑没改这个参数,于是每次拿到的都是第一页的 30 条,数字稳定、格式正确、看起来毫无异常。沉默的陷阱比报错更难发现——报错至少会喊一声。

这条发布链路上,类似的坑不止一个。把二十天的执行记录翻出来重读,能归纳出五条各自有真实出处的教训。

  • User-Agent 是准入门槛,不是可选项。 dev.to 对默认的 Python-urllib 直接回 403,带任意非空 UA 就回 200,accept 头只是障眼法。
  • 标题归一化决定幂等判重。 对方会把全角转半角、把 × 收成空格、转小写、去标点;本地若用原文精确匹配判重,已发文章就对不上,重发即 422。
  • 分页截断是沉默的统计陷阱。 默认 30 条的上限让计数恒报 30,看起来服务正常,实则统计被砍。
  • 可证伪的回查优于一次打印。 PUBLISH_OK 只是代码的自信,发布前后各拉一次全量、再用单对象接口核验,只有 delta 等于 1 且对象存在,才判 RECONCILE_OK。
  • 日志即记忆,规范即护栏。 403 根因、422 暗门、× 收空格的误报,每一次都写回通道文档与执行记忆,才没有重复踩坑。

标题归一化那段代码值得单独看一眼。它用 NFKC 归一化打底,把 ×、✕、∗、⨯、⋅、· 这类乘号统一替换成空格,再转小写、压缩空白、剥掉非单词非中文字符,最后把空格换成连字符。整套逻辑是在逼近对方的形态,而不是复刻一份官方规则——因为对方并没有公开这套规则。

回查脚本的判定条件同样值得抄下来:发布前拉一次全量文章列表,发布后拉一次,再单独请求一次文章对象确认存在。两个条件同时成立才算真发出去。单看一次打印的成功标记,等于把一根细线当成了闭合环。

这五条串起来其实是同一句话的五种说法:不要相信“看起来成功”,要相信“能被验证的成功”。403 是请求发出去了但不算成功;422 是以为没发其实发了;per_page=30 是统计出来了但被截断;PUBLISH_OK 是打印了但没落库。

复盘的价值也许不在记住正确答案,而在记住当初是怎么被骗过去的。记住那个错误的直觉,比记住修正后的代码更能防下一次。二十天里真正的变化,不是多会了几个接口,而是对每一个成功信号多问一句:证据呢?

这套护栏从挂账到落地隔了整整 8 天。写下待办和做完待办之间,隔着一条责任的缝隙。眼下还挂着一件事:给回查脚本加 5 分钟冷却护栏,防止手滑连发撞 422,从 11-07 一直排到现在,每次都被“更紧急的事”挤掉。

还有几个问题没有答案。标题归一化是经验逼近,那套 × 在标题收空格、在 slug 收成 x 的映射,会不会哪天被对方改掉?回查依赖前后计数差值为 1,若同一分钟内有人手动发了别的文章,delta 会不会误判?如果主通道将来从 dev.to 迁走,这套针对它的归一化会不会变成技术债?