代理连接故障导致任务重复提交如何避免
代理 IP 连接故障不等于业务没执行。给每个写操作分配稳定 ID,超时后先查处理状态;仍无法确认时进入人工复核,避免盲目重发造成重复提交。
连接报错不一定意味着目标端没有执行请求。请求经代理 IP 发出后,如果响应超时或连接重置,目标端可能已经完成写入;因此,写操作应使用稳定的操作 ID,并在重发前查询处理状态。
代理连接故障后,哪些请求重试会造成重复提交?
同样是报错,风险完全不同。只有请求确实到过目标端,重发才会造成重复。
| 故障形态 | 会不会重复提交 | 判据 | 处置 |
|---|---|---|---|
| 连接未建立(握手、认证阶段失败) | 通常不会 | 客户端或代理日志显示请求未进入目标端业务层;仅凭握手、认证错误码不足以证明 | 确认未进入业务层后再重试 |
| 请求已发出、响应未收到(读超时) | 会 | 本地有发送记录,目标端可能已处理 | 先按操作 ID 查状态 |
| 响应已收到、连接中途断开 | 一般不会 | 已拿到完整响应内容 | 按响应结果处理 |
| 代理层超时,但目标端已处理 | 会 | 代理报超时,业务端有记录 | 查状态,不重发 |
请求没发出和已收到响应,通常可以重试
请求没有发出,或已经收到完整响应并能据此确认结果,通常可以按业务规则继续处理。请求已经发出、但响应缺失或不完整时,先查目标端状态再决定。超时后的重试判断可参考代理请求超时、失败重试和故障转移的设计。
请求已发出但结果未知,先查处理状态
这四种形态在日志里长得不一样。握手或认证阶段失败时,客户端连「已发送」状态都不会写入;读超时会有发送完成记录但没有响应;中途断开只留下部分响应体。代理报超时、业务端却有记录的情况,只能靠目标端反查。
第一步是按日志里有没有发送完成记录分成两类,再逐类细分。日志能证明请求发出去了,却证明不了对方处理了,所以下面两个问题要分开答。判断顺序很简单:先问这个请求有没有可能已经到达对方,再问重发一次的代价是什么。两个问题都答不上来时,默认不重发。
哪些写操作不能直接重试?
副作用越大,越不能靠多试一次来确认。把写操作按代价分级:
| 操作类型 | 重复一次的代价 | 重试前必须确认什么 |
|---|---|---|
| 支付、扣款 | 直接资损 | 按操作 ID 查交易状态与流水 |
| 创建(订单、工单、账号) | 产生重复实体 | 查该 ID 是否已生成对象 |
| 提交(表单、审核、申报) | 覆盖或重复提交 | 查回执与最终状态 |
| 发送(消息、通知、邮件) | 对方收到多次 | 查发送记录 |
| 删除、撤销 | 状态可能已变更 | 查当前状态,不复用原请求 |
读操作,以及协议层面幂等的写入(重复执行结果一致),代价较低。但协议幂等不等于业务幂等,业务侧仍要确认。
目标端支持幂等键时,重发是安全的——前提是复用同一个键,而不是每次生成新键。判断标准只有一个:同一个键发两次,对方返回的是同一笔业务还是两笔。更完整的重试前置判断见 自动化任务重试代理请求前要检查什么。
代价分级之外,还有一类边界要单独说。代理 IP 认证失败(407)只说明代理侧没有放行这次请求,不等于目标端一定没收到:请求仍可能穿过代理到达业务层。要排除重复提交,得核对发送记录和目标端状态;连接超时和连接重置的风险更高,但同样需要状态确认。
重试前如何确认目标端是否已经处理?
按操作 ID 查询,再核对业务记录
- 本地操作 ID 记录:这一次业务意图对应的 ID、目标、请求摘要。
- 目标端状态接口或回执:按 ID 查询,优先使用对方提供的查询能力。
- 服务端日志或对账文件:前两层都查不到时的兜底。
根据查询结果决定重试、停止或转人工
查到已处理就不重发;查到失败可以重试。查不到结果、或只拿到暂态时,先记为未知,按复核窗口再查一次,仍未查到就转人工;两边记录矛盾时,以业务权威记录为准,并留下核对痕迹。
查不到时不要无限重查。设一个复核窗口(按业务时效定),窗口内按固定间隔再查一次;仍查不到就转人工,留下操作 ID。由谁接手、多久必须给出结论,这两件事都要写进变更规则或值班规则。每次状态核对都应留下记录,便于后续追踪;凭据和完整业务数据不要写入日志。
| 记录项 | 建议记录 |
|---|---|
| 操作标识 | 操作 ID、业务主键、请求摘要 |
| 故障形态 | 未建立、未收到响应、中途断开、代理超时 |
| 确认层 | 本地、目标端接口、服务端日志 |
| 结论 | 已处理、失败、未知、矛盾 |
| 时间 | UTC 时间戳与重试次数 |
常见问题
操作 ID 由谁生成比较稳?
由发起方在本地生成,随请求带上并写进日志。目标端支持幂等键时优先用它的键,不支持时靠本地 ID 反查。
同一个操作 ID 能跨批次复用吗?
不能。它绑定这一次业务意图,跨批次复用会让状态查询分不清新旧;重跑就生成新 ID,并留下与旧 ID 的关联。
代理 IP 返回 429 后重发,算不算重复提交?
不能只凭 429 状态码判断是否有副作用。应结合接口说明和目标端记录确认请求处理结果;确认未处理且符合接口重试要求后,再按 Retry-After 或文档给出的等待时间重试。写操作仍应使用幂等键或先查状态。
已经重复提交了,怎么收场?
先按 ID 找出重复生成的对象,标记作废或人工合并,并补一条变更记录。直接删除会丢掉证据链,错误码与时间窗的对照见 代理 IP 故障排查中心。
