移动端弱网下的请求重试与幂等处理
移动端弱网下的请求重试与幂等处理
问题背景
移动端网络状态不稳定,页面在弱网环境里经常出现请求超时。最初的做法是失败后直接重试两次,但上线后发现同一个订单被创建了多次,部分支付回调也出现了重复入账。问题不在重试本身,而在重试之前没有确认接口是否具备幂等能力。
先区分两类请求
不是所有请求都适合自动重试:
• 查询类请求通常可以重试,例如商品详情、配置、列表;
• 写入类请求要谨慎,例如创建订单、提交表单、扣减库存;
• 支付、退款、积分变更等涉及资金和权益的接口,必须由服务端提供幂等键。
判断标准不是请求方法,而是业务语义。一个 `POST` 查询接口可能天然幂等,一个 `GET` 接口也可能因为计数逻辑产生副作用。设计重试前先把接口按业务影响分类。
幂等键的生成
客户端在第一次提交前生成一个唯一请求号,后续重试始终复用同一个值,例如:
Idempotency-Key: 7f3c2a9e-6b1d-4a8e-9c21-5d0f8b7a1e42
这个值只在一次业务操作的生命周期内有效。页面刷新后重新发起同一笔业务,应该生成新的请求号;同一次提交内的网络重试,必须沿用旧请求号。
服务端收到请求后先查幂等记录:
1. 没有记录:执行业务并写入请求号;
2. 已有成功记录:直接返回第一次的结果;
3. 已有处理中记录:返回处理中,客户端继续轮询;
4. 已有失败记录:按业务规则决定是否允许重试。
幂等记录和业务数据要在同一个事务边界内提交,否则会出现“业务成功但记录没写入”的空洞。
重试策略
重试不能简单地循环固定次数。更稳妥的策略是:
• 只对网络超时、连接失败、明确的 5xx 错误重试;
• 参数错误、鉴权失败、业务校验失败直接返回,不重试;
• 使用指数退避,例如 1 秒、2 秒、4 秒,并加入随机抖动;
• 设置总时长上限,避免用户长时间停留在加载态;
• 页面切到后台或用户主动取消时停止重试。
固定间隔重试容易在服务端故障时形成请求尖峰,指数退避加抖动可以分散压力。
客户端状态管理
重试期间要保持提交状态,避免用户重复点击。按钮进入提交态后,应该锁定本次操作,直到收到明确结果或超过总时长。提示文案也要区分:
• “网络不稳定,正在重试”;
• “提交处理中,请稍候”;
• “提交失败,请重新尝试”。
不同状态对应不同用户动作。把所有失败都显示成“请重试”,会让用户在主流程外反复点击,进一步放大重复提交。
服务端的兜底
即使客户端做了幂等键,服务端仍然要防重复:
• 数据库对业务唯一键加唯一索引;
• 支付回调按外部流水号去重;
• 积分、库存等变更使用条件更新,避免并发覆盖;
• 异步任务消费前先检查消息是否已处理。
客户端幂等键解决的是同一笔操作的重复提交,服务端唯一约束解决的是更广范围的并发与重放。两者不是替代关系。
验证方法
上线前可以用以下方式验证:
1. 同一幂等键连续发送 3 次,确认只产生一条业务记录;
2. 模拟第一次请求成功但响应丢失,确认第二次返回同一结果;
3. 模拟服务端超时后继续处理,确认客户端轮询能拿到最终状态;
4. 并发发送同一幂等键,确认唯一索引或分布式锁生效;
5. 断开网络后恢复,确认重试不会生成第二笔业务。
这些场景比单纯的接口连通性测试更接近真实弱网环境。
总结
重试的关键不是“失败几次后重来”,而是明确哪些请求可以重试、同一次操作如何被识别、服务端如何兜底。客户端幂等键、合理的退避策略、清晰的提交状态和服务端唯一约束配合起来,才能在弱网下既保证成功率,又不产生重复业务。
- 点赞
- 收藏
- 关注作者
评论(0)