重跑一次脚本，我多发了两篇稿：自动化流程的幂等设计复盘

我给自己搭了个每日自动化任务：早上九点，定时器触发一个 Agent，写一篇 800–1500 字的技术文章，落盘到指定目录，再调用发布脚本推到腾讯云开发者社区。链路不长，稳定跑了二十多天。

那天脚本执行到发布阶段，网络抖动，请求超时，脚本退出码非零。我当时的处理非常"工程师直觉"：重跑一次不就行了。重跑之后返回 SUCCESS，我甚至没多看一眼。

三天后我打开创作中心，发现同一篇文章挂着两份，标题一模一样，正文一模一样。更麻烦的是时间线还错位——重复的那份落在了不同的日期目录下，看起来像两篇内容不同的稿子。

平台没有删稿接口。我只能手动进后台处理。

复盘的时候我发现，问题根本不在超时，而在我把"重试"当成了默认解药。

超时那一刻，链路里其实已经发生了两件事：文章确实发出去了；但脚本没拿到成功的响应。这是典型的**半成功状态**——副作用已生效，确认信号丢失。

而我的脚本把两类失败混成了一种：

- **可重试失败**：连不上、DNS 超时、本地文件没写成功。重跑是安全的。

- **不可重试失败**：请求已到达服务端、副作用已成事实。重跑等于制造重复。

判断标准其实很简单，就一句：这次失败，是否可能已经改变了外部世界。答不上来，就不该自动重跑。

改完之后链路是这样的，思路可以复用到任何"有外部副作用"的自动化脚本上。

**第一层：幂等键。**每篇文章落盘时，就以业务日期作为天然幂等键，文件名固定为 `YYYY-MM-DD.md`。发布前先查一下本地状态文件里这一天是否已有成功记录；有，直接跳过，不重复投递。幂等键要选业务意义上的唯一标识，不要用时间戳或随机 ID——后者只会让每次执行都变成"新任务"。

**第二层：状态落盘，先探测后执行。**脚本不再"无脑执行"，而是分三段：探测 → 判断 → 执行。执行结果写进一个 state 文件，格式极简，一行一个 `日期 -> 状态`。状态只有三种：pending / done / failed。启动时读状态，done 的直接跳过。这一步的价值在于把"记忆"从我的脑子里挪到了磁盘上，脚本自己知道干过什么。

**第三层：失败只报不重跑。**这是最反直觉、也最有效的一条。不可重试类失败，脚本只负责把错误码和上下文打出来，绝不自动重试；可重试类失败，最多重试两次，且必须带退避间隔。至于判断不了的类型，一律归入"报错给人看"。

特别提一下 401：登录态失效属于典型的不可重试失败。凭证不是脚本能自己恢复的东西，重试一百次也是 401。脚本该做的就是把"请重新扫码并更新 cookie 文件"这句话打给用户，然后干净退出。

**给脚本留一个 dry-run 开关。**上线任何新的自动化链路之前，先空跑一遍，把"将要做什么"打出来，而不是真的做。我第一次改完幂等逻辑，就是靠 dry-run 发现探测分支写反了——它把 done 的记录也当成了待执行。

**入参越少越好。**我最初想给发布脚本加一堆参数：标题、标签、分类、摘要、封面。后来收敛到两个：文章路径 + 一句话摘要。参数越多，调用方越容易传错，而自动化链路里没人盯着你传参。标题从正文一级标题解析，标签从文件前缀推导——能从产物里推导出来的东西，就不要让调用方再传一遍。

**留痕比日志级别重要。**与其调 log level，不如保证每次执行都留下一行"何时、对哪个幂等键、做了什么、结果如何"。出问题时看这一行就够了，不需要翻完整的堆栈。

**把重试权交给上游。**定时器只负责触发，不负责判断成败。判断权在脚本内部的状态文件里。职责分清之后，重跑就变成了一件安全的事——因为脚本自己会跳过已完成的部分。

改完之后连续跑了三十多天，零重复投递，也再没有出现过"人工去后台收拾"的情况。人工介入的频次从每天检查降到了每周抽查一次，我只需要看状态文件里有没有 failed。

这套东西跟领域无关。后来我把同样的三层护栏搬到了另外两条链路上：一条是设计稿的批量导出与归档（幂等键用稿件编号），一条是周度报表生成（幂等键用周次）。都成立。

自动化真正的成本从来不在"能不能跑通"，而在"跑出问题时会不会留下烂摊子"。让步骤可重跑、让状态可查、让失败可归因——这三件事做完，一条脚本才算真的能用，而不是只能演示。

一次脚本超时重跑导致重复发文的实战复盘：用幂等键、状态落盘、失败分类三层护栏，让自动化链路可以安全重跑。

架构设计

开发工具

后端

自动化脚本因网络超时重跑导致重复发文，暴露半成功状态风险。通过幂等键（业务日期）、状态落盘（探测-判断-执行）及失败分类（可重试/不可重试）三层防护，实现零重复投递。dry-run、精简入参、留痕记录等细节提升可靠性，方案可迁移至批量导出、报表生成等场景，降低人工介入成本。

Agent

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

重跑一次脚本，我多发了两篇稿：自动化流程的幂等设计复盘

重跑一次脚本，我多发了两篇稿：自动化流程的幂等设计复盘

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐