比「点成功」更难的是「证明做过」:自动化任务脚本的幂等与判据设计
【摘要】 从动作幂等、成功判据构造、缓存与批量落库的时间差三层,拆解自动化任务脚本为什么会在成功之后谎报失败,并给出一份可执行的落地清单。
比"点成功"更难的是"证明做过":自动化任务脚本的幂等与判据设计
## 一个反直觉的观察
写自动化脚本的人,最初级的成就感来自"按钮被点动了"。屏幕上弹出一个 toast、页面跳转到某个完成页、按钮从"去完成"变成"已完成",看上去一切都对。但只要连续跑一个月,就会发现真正消耗时间的从来不是"点不动",而是"点动了却不知道算不算数"。
我维护一套每天定时跑的浏览器自动化任务,二十多天里踩到的坑,八成集中在同一个地方:动作已经执行,但判据写错了,于是脚本认为自己失败,又做了一遍;或者认为成功,其实什么都没发生。 这两类错误方向完全相反,造成的损失却一样真实——前者留下重复内容,后者留下一天的空窗。
下面把这件事拆成三层:动作的幂等性、成功判据的构造、以及两者失败时的回退策略。
## 第一层:动作必须先能重复执行
幂等不是"重复执行结果不变"这么一句口号,它在实现上有个很具体的前提:**执行前必须先能读到当前状态**。
一个可靠的动作函数应该长这样:
```
1. 读取当前状态 S
2. 如果 S 已经满足目标条件 -> 直接返回 ALREADY_DONE,不做任何动作
3. 否则执行动作,最多重试一次
4. 重新读取状态 S',用它判断成败
```
关键在于第 2 步。很多脚本省略它,直接进入动作,理由是"页面上的按钮存在就说明该点"。但按钮存在只说明这个页面允许你点,不说明服务器端还没收到过这次请求。签到按钮在已签到的状态下通常换个文案,可如果站点把它渲染成同一颗按钮、只是点了没反应,脚本就永远不知道自己处在哪一步。
更麻烦的是有些动作本身**不幂等且不可撤销**。比如给仓库点 Star——同一颗按钮在已 Star 的状态下再点一次,语义就变成"取消 Star",而取消之后再点回来,很多平台会把它记为两次不同的事件,甚至影响当天的计分资格。这类动作必须做到"读到目标状态就不碰",一次判断失误比十次重试都贵。
所以判断标准不是"这个按钮能不能点",而是"我有没有办法在执行之前知道它已经被点过"。没有这个能力,就不要把动作放进循环。
## 第二层:成功判据要用两个互相独立的信号
单一判据几乎一定会在某个版本更新后失效。我遇到过三种典型的坏判据:
其一,用 URL 变化当成功条件。 某个发布表单提交成功后会跳到 `processcomplete?type=xxx`,但脚本只认路径里带具体资源 id 的那种 URL,于是每一次真实成功都被判成失败。脚本的重试逻辑接着又提交了一遍,页面上出现两条内容。
其二,用按钮的可见性当成功条件。 提交成功后按钮被替换成一个零尺寸的隐藏节点,Selenium 点它会抛"元素被遮挡"异常。如果脚本把异常当成"提交失败",那就是在成功之后立刻谎报失败。
其三,用文案的子串匹配当状态条件。 活动页角落永远写着一行"已报名人数:1234",用"已报名"三个字做判断,在完全没报名的页面上也会命中。这类假阳性比假阴性危险得多,因为它让人安心。
比较稳的构造是同时拿两个来源交叉验证,并且让它们走不同的通路。比如判断一次签名动作是否生效,我会同时看两处:**界面上的状态文本**(面板是否已经显示完成文案)和**服务端的账本数据**(从页面的异步接口里读到的明细记录,带时间戳和变动后的余额)。前者是给人看的,后者是给系统记的,两者由不同的代码路径渲染,同时出错的概率很低。
更进一步,账本类数据通常带余额字段,可以做**算术校验**:动作前余额 B0、动作后余额 B1,这笔记录的变动量是否等于 B1 − B0。这条校验能拦住"记录写了但金额算错"这类罕见但确实存在的故障,也让日志具备可审计性——日后有人问"这一分是怎么来的",一行记录就能回答。
## 第三层:动作与判据之间的时间差,才是真正的敌人
即使判据本身正确,它读取的时刻也可能太早或太晚。
太早的典型现象是**页面缓存**。任务面板是一次性渲染的,动作完成之后同一个标签页反复读取,读到的仍是几分钟前的旧状态。我为此浪费过整整两轮排查,直到发现重新导航一次页面,分数就变了。结论很朴素:**判断"没到账"之前,必须先强制刷新一次数据源**,而不是拿同一份缓存当证据。
太晚的问题在批量写入的系统里。有些平台不是"行为触发即记账",而是按时间窗口批量落库,行为发生到记录可见之间可以差十几分钟甚至近一小时。这种情况下,脚本如果在 30 秒内回查就断言失败,就会把一堆当天只能做一次的任务全部重做一遍——既不加分,又在站点上留下痕迹。
正确的做法是把"站点侧已完成"和"账本侧已入账"当成两个独立的状态来记录,允许它们短暂不一致:
```
状态 A: 页面证据已取得(完成页 URL / 停留时长已满足 / 按钮已变灰)
状态 B: 账本出现对应记录
汇报时分别写清楚:A 已达成,B 待入账,明日复核
```
这套写法最大的收益不是准确性,而是**它消除了重复执行的理由**。人之所以会重做,是因为不知道到底算不算数;一旦"待入账"成为合法状态,就没有必要再碰一次。
## 一个反例:为什么"多试几次"是坏策略
直觉上,失败就重试。但自动化任务里的重试要分两类:
- **读操作失败**可以重试,代价几乎为零,最坏情况是多等几秒;
- **写操作失败**不能无脑重试,因为你不知道上一次到底写成功了没有。
区分这两类的唯一办法,还是回到第一层:**写操作之前能不能读到状态**。能读,就重试也无害;不能读,就应该把失败如实上报,把决定权交回给人。
一个反例是我早期的一段上传逻辑:文件上传动作返回了空值,脚本据此判断"没传上去",循环了三次。实际上第一次就成功了,返回空值只是这个接口的正常返回格式。页面上传次数从 0/1 变成 3/1,多出来的两条记录既删不掉,也让当天的配额彻底用尽。返回值不是判据,页面状态才是。 这句话我后来写进了每一个上传脚本的注释里。
## 落地清单
把上面三点压缩成可执行的规则:
1. 动作函数第一行永远是"读状态",读到目标状态就直接返回,不做任何点击。
2. 判据至少两个来源,且一个来自界面、一个来自数据接口,不与动作共用同一条请求链。
3. 金额类数据做算术校验(变动量 = 余额差),不只看"记录存在"。
4. 判"没到账"之前强制刷新一次数据源,禁止拿同一个标签页的二次读取当结论。
5. 汇报里把"站点侧完成"与"账本待入账"分开写,允许它们短暂不一致。
6. 写操作的重试只在"能读到状态"的前提下允许,且最多一次。
7. 任何返回值为空、为 null、为 `{'value': None}` 的接口,都不要用它判断成败。
## 收尾
自动化真正难的部分,不是让机器替你点按钮,而是让机器替你说清楚"这件事到底做没做"。前者是操作,后者是证据链。当一份脚本的报告能让人不需要再打开浏览器核对,它才算写完了;在那之前,它只是一个会动的玩具。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)