关键词优化助手：脚本调用工具遇到限流时怎样保护已有结果
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /24efc33171fd.html
📄
关键词优化助手：脚本调用工具遇到限流时怎样保护已有结果
先给结论：限流发生后，第一动作不是重试，而是把已返回的结果立即落盘并冻结，再按“已完成、部分完成、未开始”三种状态拆分任务。只有确认哪些结果已经完整、哪些字段缺失，才能决定是续跑、补跑还是重跑，否则反复调用只会让更多结果处于不确定状态。
先判断限流信号属于哪一类
脚本收到的限流反馈通常有三种表现：明确的频率拒绝、连接被重置、以及返回内容为空但状态正常。三者对应的处理方式不同。明确拒绝说明当前节奏已超限，应停止调用并等待；连接重置可能是网络或服务端保护，需要降低并发而不是单纯延长间隔；返回空内容最危险，如果脚本把它当成“已完成”写入，就会污染已有结果。
判断依据可以看三点：同一批请求中失败是否集中在某个时间窗口；失败是否随并发数下降而减少；重试同一参数是否稳定复现。如果只有高并发时失败，问题在节奏；如果单次调用也失败，问题可能在参数或权限，继续重试没有意义。
把已有结果转成可续跑的状态文件
以读者手中一份正在跑的脚本任务为例，假设它要处理一批待优化词条，每条需要调用工具获取建议。限流出现时，脚本可能已经处理了一部分。此时应立刻做一次状态固化，而不是让脚本继续循环。
- 把已成功返回且字段完整的记录写入一个结果文件，例如
done.jsonl，每行一条，保留原始输入和返回内容。 - 把已调用但未拿到完整结果的记录写入
pending.jsonl，并标注失败类型，如rate_limit、empty、timeout。 - 把尚未调用的记录留在原始输入文件中，不要提前标记。
- 记录本次运行的参数快照，包括并发数、间隔、时间范围，便于下次对比。
这个动作的结果是：你得到一份可核对的边界。下一步续跑时，脚本只读取 pending.jsonl 和未处理输入，已经完成的词条不会再被调用，已有结果不会被覆盖。
续跑时先降并发，再决定补跑范围
续跑不等于把原脚本重跑一遍。应先降低并发和调用频率，用一小批 pending 记录试探当前限制是否解除。如果小批成功，再逐步放量；如果仍失败，说明等待时间不够或触发条件未消失。
补跑范围取决于缺失字段的重要性。若返回结果中只有次要字段缺失，可以保留主结果并单独补字段；若主结果本身为空，应把该条退回未处理状态，而不是保留半条记录。一个可操作的判断是：把每条记录按“可直接使用、需补字段、需重跑”分类，只有第三类才重新进入完整调用流程。
用去重键防止重复写入和结果漂移
限流场景下最常见的二次损坏是重复写入：续跑时同一词条被再次处理，结果文件里出现两条记录，后续统计和导出都会失真。解决办法是在写入前用稳定去重键判断，例如输入词条加参数组合的哈希值。写入时采用追加模式，并在读取阶段按去重键保留最新一条完整记录。
另一个风险是结果漂移：同一词条在限流前后两次调用返回不同建议。此时不要直接覆盖旧结果，而是把两次结果都保留，并标注调用时间。这样你能看出差异是限流导致的偶发返回，还是工具侧本身不稳定。若差异集中在限流恢复后的第一批，通常说明该批结果需要复核。
把保护动作固化成下次可复用的检查点
限流不是一次性事故，脚本长期运行就会反复遇到。值得固化的是三个检查点：调用前写入任务清单、调用中按批落盘、调用后校验记录数与去重键。假设一批一百条记录，正常应得到一百条完整结果；若结果文件只有八十七条且其中五条字段为空，那么实际可用的是八十二条，剩余十八条应进入补跑队列。这个数字只用于说明核对方法，不代表任何工具的实际限额。
需要核对工具自身的频率规则、配额说明和返回字段定义时，应以该工具当前官方文档为准，不同工具的限制条件和错误码并不通用。做完上述固化后，下一步不是立刻扩大调用量，而是先用补跑队列验证恢复后的返回是否稳定；稳定后再恢复原节奏，并把本次的并发和间隔参数记入脚本配置，避免下次从默认值重新试错。
