定时任务幂等性设计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @mayishebao/mayishebao-1207-0207。
技能介绍
定时任务为什么总会重复执行
在中国团队的脚本和平台里,同一个任务被调度系统触发多次是很常见的:cron 间隔过密、消息队列重投递、手工补跑、发布期间滚动重启,都可能让一次支付对账、扣款回调或数据同步跑上第二遍。幂等性设计要回答的不是「有没有异常」,而是「重复执行时业务状态是否仍然正确」。
很多团队只在入口处加一个 if (已处理) return; 式的标记位,遇到数据库状态没落库、唯一索引缺失、补偿任务与主任务并发、跨进程锁过期等情况,就会暴露出新的重复数据。这个技能的价值在于把问题从「看起来加了锁」推进到「证据可追溯」。
它如何工作
技能围绕定时任务的幂等性做一次完整方案交付,而不是给一段通用模板。
- 复现优先:先拿到代码仓库或最小复现,确认重复触发的真实路径,再讨论锁和标记位是否有效。
- 最小可逆变更:在分布式锁、数据库唯一约束、状态机、去重表、补偿任务之间做方案比较,给出推荐项和备选方案的差异。
- 测试补齐:针对单元、集成两类场景补测试用例,重点覆盖重复触发、超时恢复、部分失败后重跑。
- 发布与回滚:说明上线顺序、监控指标、回滚条件,避免把设计停留在"交个方案"这一步。
输出遵循固定结构:问题定位、证据、方案比较、变更清单、测试用例、发布与回滚步骤、遗留风险。结论会指向用户提供的代码、日志或计算过程;信息不够时保留占位,需要交叉确认的事项会先列出关键问题再给方案。
适用边界
这个技能不替代正式代码审查。跨时区、跨地区的合规约束(例如跨日期临界点触发)需要结合项目的调度配置和部署拓扑判断。日志和测试数据在示例中默认脱敏。技术方案本身不覆盖企业真实的用工、社保、税务决策,涉及此类事项时需另行按合规口径复核。
使用场景
- 线上定时任务重复执行,需按证据定位并出可回收的变更方案
- 评审补偿任务时,需比较分布式锁与唯一约束的取舍并补测试
- 参数或环境变更要上线,需写清发布顺序与回滚条件
- 跨团队接手定时任务,需要能追溯到日志与计算过程的说明与测试校验
适合人员
- 后端开发:把重复触发改成最小可逆变更并提供单元与集成测试
- 测试工程师:根据业务约束为重跑与超时恢复设计用例
- 运维与发布负责人:需要写发布顺序、监控指标和回滚条件
- 数据与平台工程师:处理数据同步重复与任务状态一致性