SuperAPI AI 工具集

principle-make-operations-idempotent

编程与开发

查看项目

更新于 11-19 03:05

技能介绍

该技能是一条设计原则,主题为“让操作具备幂等性”。其核心目标是:设计操作时,使其无论运行多少次、从什么起点开始,都收敛到正确的状态。资料建议每个会改变状态的操作都先回答:如果这个操作运行两次会怎样?如果上一次运行中途崩溃会怎样?

用途与背景:命令、生命周期操作和处理循环所处的环境里,崩溃、重启和重试都是常态。如果部分状态变化会影响下一次运行的结果,那么每次重启都会变成一次调试过程。因此该原则用于指导这类操作的设计。

主要模式:

  1. 收敛式启动:扫描已有状态、清理陈旧产物、接管存活会话。
  2. 基于内容的清理:按内容等价性比较,而不是按创建顺序。
  3. 自愈锁:使用基于 PID 的陈旧锁检测。
  4. 幂等调度:失败的工作可以干净地重生,每轮循环后重新生成新的输入。

自检方式(测试):

  • 如果连续运行两次会怎样?
  • 如果上一次运行在每一个可能的点崩溃会怎样?
  • 重新执行是否会收敛到同一个终态?

如果任一答案都是“取决于遗留了什么状态”,则该操作需要一个对账(reconciliation)步骤。

适用场景:设计命令、生命周期步骤或处理循环,尤其是运行在崩溃、重启和重试环境中的操作。

限制:资料未提供具体代码实现、安装命令、平台支持范围或收费信息,暂未提供。