Marvis 五类失败分别怎么回滚

2026-11-16 15:37 更新

失败先分类再动手,五类的退路不一样,混着处理会更乱。

遇到失败时最常见的反应是重跑一遍。这个反应有时对,更多时候是白费——如果失败原因是确定性的(格式不支持、路径不存在、权限没给),重跑只会重复同一个结果,而你可能因此以为「它不稳定」,把问题记到错误的原因上。

分类的目的就是避免这件事。判断自己遇到的是哪一类,比急着动手重要:类别决定动作,而动作分四种——重试(同参数再来一次)、重跑(改参数再来一次)、恢复(把环境还原)、兜底(手工做完)。选错会浪费一轮,重试与重跑的差别尤其容易混。

官方的文档里没有任何失败处置说明:没写撤销、没写重试、没写产物保留,也没写任务卡住时该走哪条路。所以这一节的五类不是抄来的分类,是从可观察现象出发划的编辑分类。它的用途只有一个:让你在三十秒内决定下一步按哪个键,而不是盲目重跑。

前提与适用

项 说明
适用读者 任务跑完没结果的人;结果有了但打不开的人;重跑三次结果都不一样的人;要把排障顺序写进团队流程的人
事实边界 五类划分为编辑分类,官方无失败处置说明;引用的不稳定现象来自单文件夹只读任务的两轮对照
版本基线 客户端 1.60.3400.35;官方文档页最近一次更新早于官方资讯稿
不适用 想知道怎么事先验收避免失败——见验收清单四项;想理解它为什么会在关键动作前停下——见什么任务不该自动拆

怎么做

先做一个三问分层,三十秒内定类别。

不要一上来就看细节。先问三个问题,每问一个就能砍掉一部分可能:

第一问:它有没有真的开始跑? 看有没有出现步骤或状态,看有没有任何中间输出。完全没有 → 归入「没跑起来」,往下别再查结果,查启动条件。

第二问:跑完了有没有产物? 有状态推进、有结束提示,但产物区是空的 → 归入「产物为空」。

第三问:产物在,内容对不对? 打得开但数字对不上、条目缺、两次结果不一致 → 归入「结果不对」。打不开 → 归入「产物损坏」。

三问都过不了还有第五类:动作被拦住了。它明说没权限、要你授权、这类动作它不做。这一类不是失败,是设计,处理方式完全不同——不要想办法绕过它。

第一类:没跑起来。

特征是没有任何中间输出,或状态停在第一步不动。常见原因有三个,按排查成本从低到高排:

启动条件不满足。定时任务和自动任务有一句明确的限制:关机、休眠或退出客户端时,自动任务无法执行。这不是 bug,是设计前提——任务要在本机跑,机器得开着。所以「昨天设的定时任务今天没跑」的第一嫌疑不是它忘了,是昨晚电脑睡了。

额度或网络问题。需要联网的任务在断网下必然失败,官方写得很直白:需要联网的信息查询类任务在断网状态下无法使用。这一条与模式无关,本地模式再强也搜不到今天的机票价格。

客户端本身没起来。托盘图标在不在、进程有没有、登录态有没有过期——这三项逐一看,比在对话里反复重发指令快。

第二类:产物为空。

状态跑完了,产物区什么都没有。这一类最常见的原因是范围没对上:你说的目录和它理解的目录不是同一个。

处理顺序是:先让它复述它扫了哪个路径,再看那个路径下到底有没有东西,最后才怀疑能力问题。多数情况到第二步就结束了——路径指向了一个空目录,或者指向的是快捷方式而不是真实目录。

还有一种情况值得单独说:任务本身成功了,但产物被判为「无内容」而没有生成。比如让它整理一个全是空文件的目录,它可能正确判断「没什么可整理的」,于是不产出。这时该看的不是失败日志,是你给的范围是否合理。

第三类:产物损坏。

文件在,双击打不开,或打开是乱码。两类原因:写入没完成(任务还在跑,或刚结束还在落盘),以及格式或编码选错(尤其 csv 的中文编码、xlsx 的兼容模式)。

先等十秒再看,这一条能解决相当一部分「打不开」。还在跑的时候去开产物,等于在写入过程中读文件。

仍打不开就换格式重导,不要在损坏的文件上修——修出来的东西你无法确认内容完整性。表格类优先 xlsx,纯数据用 csv,文本用 md 或 txt,这条顺序能避开大部分兼容问题。

第四类:结果不对。

最难的一类,因为「不对」有三种完全不同的成因,处理方式相反:

条目少了。有文件被跳过——隐藏文件、无权限目录、不支持的扩展名。这时不要重跑整批,让它列出「哪些没进产物」,你手工补那几条更快。

条目全但内容错。读的是旧索引:文件改过,索引没更新。这时重跑有效,但要先确认索引刷新了;对同一目录连跑两次,两次结果一致才说明索引稳定了。

两次结果不一致。这一类有实测记录:同一份日志文件,在表格输出那一轮被报成 4 行,文件实际 3 行;同一任务再跑一轮,报的是正确的 3 行。也就是说字节数与文件数是稳定的,行数与文字描述会跨运行漂移。遇到这种情况,判据要以可数的量为准:字节数、文件数、行数自己去数一遍,别信描述。

第五类:动作被拦住。

它明确表示不做,或要求你先授权、先确认。这一类要分清两种性质:一种是权限没给(你可以决定给不给),一种是产品硬边界(给不了)。

权限类的处理很简单:按它说的入口授权,或换一个有权限的目录。硬边界类的处理是接受——比如支付类动作它不代你操作,必须由你本人完成。这类拦住的正确反应不是重试,是换分工:它做前面的准备,最后一步你自己点。

参数与边界

项 说明
四个动作的区别 重试=同参数再来;重跑=改参数再来;恢复=把环境还原(原件、索引、授权);兜底=手工做完
分类不重叠 五类按「有没有跑—有没有产物—产物对不对—有没有被拦」四问划分,同一现象只归一类,避免两头处理
不覆盖未知失败 四问都不命中时按「未分类」处理:先记录现象再动手,不要在没记现象的情况下重跑,重跑会抹掉现场
不覆盖第三方现象 五类来自公开可观察现象与本机一轮对照,未覆盖多 Agent 并行、跨端任务与联网抓取的失败形态
重试上限 同一参数最多重试两次。第三次仍失败说明是确定性问题,改参数或改做法,别再试

验收清单

# 核对项 通过标准 不合格时
1 类别判定 能说出属于五类中的哪一类,并给出判据(看到了什么) 回到三问分层,逐问记录答案,不要凭感觉
2 第一处异常 指得出「第一个不对的地方」,而不是只描述最后结果 重跑一次并全程旁观,找第一个异常点
3 原件完好 原件修改时间未变,内容可比对 先恢复原件,恢复前不要再发任何指令
4 处置记录 一行写下:类别、动作(重试/重跑/恢复/兜底)、结果 补记;没有记录的下次会重复同一轮试错
5 下次规避 能说出一个改法(改范围/改格式/改分工/改时机) 说明这次失败只是被绕过,没有被解决

失败与回滚

现象 原因判据 重试或恢复 手动兜底
定时任务昨天没执行 昨夜机器休眠或客户端退出,不满足「保持开机运行」前提 改为手动触发一次,验证任务本身能否跑通 把任务挪到你确定在用电脑的时段,或改成开机后手动跑
断网后联网任务失败 网络搜索、网页抓取、实时比价本身需要网络,与模式无关 联网后重试;不要切模式试图绕过 用本地已有的资料替代,或改天再查
产物区空白,状态显示完成 扫描范围指向空目录或快捷方式,不是真实目录 让它复述路径,确认后指定绝对路径重跑 手工指定几个具体文件再试一次,缩小范围定位
文件打不开或乱码 写入未完成,或导出格式与编码不匹配 等十秒再开;仍不行则换 xlsx 或 csv 重导 用原始工具另存一份,不在损坏文件上修
条目比预期少 隐藏文件、无权限目录、不支持的扩展名被跳过 让它列出被跳过项及原因,不要重跑整批 手工补那几条,比重跑省时间
两次结果数字不一致 行数与文字描述跨运行漂移,字节数与文件数稳定 跑第三次,取两次一致的值 自己数一遍字节与行数,以可数量为准
明确拒绝执行某个动作 属产品硬边界(如支付类不代操作),不是权限问题 不要重试,重试会得到同一句拒绝 换分工:它做前置准备,最后一步你自己完成

自检题

# 问题 参考答案要点
1 重跑三次都失败,第四次该不该再试 不该。三次同参数失败说明是确定性问题,该改参数、改范围或改分工,继续试只是消耗额度与时间
2 产物打不开,能不能直接在原文件上修 不能。修出来的内容完整性无法确认;应换格式重导或用原始工具另存
3 它说「这个动作我不能做」,属于哪一类 第五类「动作被拦住」。要再分权限类与硬边界类:前者可授权,后者只能改分工

注意与相关

Note:五类里只有第四类值得反复试——它可能是偶发漂移。其余四类的成因都是确定的,试第二次的期望收益接近零。判断「这值不值得再试一次」的能力,比记住五类的名字更有用。

Warning:不要在没记录现象的情况下重跑。重跑会覆盖现场:产物被替换、临时文件被清理、状态被重置。你省下的三十秒记录时间,后面要用十分钟去找回来,而且往往找不回来。

Tip:把这张表的「现象」列当检索表用。遇到问题时先在里面找最像的一行,找到就先按那一行的动作做,做完再看细节。排障最耗时的从来不是修,而是不知道自己在修什么。

相关:11.1 一节的验收清单该写哪四项(验收通过与否决定要不要进这一节)、4.3 什么任务不该让它自动拆(第五类被拦住的成因)、10.4 支付类动作为什么必须自己来(硬边界为什么给不了权限)。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号