支付接口超时重试必须启用幂等键、仅对5xx/网络错误重试、设3秒超时+指数退避+最多2次、全程可取消并提供明确状态反馈。
支付接口超时重试不能简单“再发一次”，必须兼顾可靠性、幂等性和用户体验。核心不是“多试几次”，而是“只在安全的前提下重试”。
必须启用幂等键（Idempotency Key）
每次支付请求都需携带唯一且可复用的幂等键，如 ULID 或服务端生成的业务 ID。服务器据此判断：同一键的重复请求，直接返回上次结果，不重复扣款。
- 前端生成：使用
crypto.randomUUID()（现代浏览器）或 ULID 库生成一次后缓存，整个重试链路复用该键 - 必须传入请求头：
Idempotency-Key: xxxxxxxx，不可随重试变化 - 若服务端未校验幂等键，重试即高危操作，应拒绝发起
只对明确可重试的错误类型触发重试
支付场景中，4xx 错误基本不可重试，5xx 和网络类错误才考虑。需严格过滤：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- ✅ 可重试：
TypeError（网络中断）、AbortError（超时）、HTTP 状态码502/503/504 - ❌ 禁止重试：
400（参数错误）、401（token 失效）、403（权限不足）、404（订单不存在）、409（冲突） - 建议把判断逻辑封装为函数，例如：
shouldRetry(err, res) { return err.name === 'TypeError' || (res && [502,503,504].includes(res.status)) }
强制设置短超时 + 指数退避 + 次数封顶
支付是强实时场景，单次请求超时建议设为 3 秒；重试间隔采用指数增长（1s → 2s → 4s），避免重试风暴；最大重试次数不超过 2 次（含首次），总耗时控制在 10 秒内。
- 每次重试都新建
AbortController，并绑定独立超时：setTimeout(() => controller.abort(), 3000) - 延迟等待用
await new Promise(r => setTimeout(r, 1000 * Math.pow(2, attempt))) - 超过 2 次失败，不再自动重试，应提示用户“支付状态确认中”，并引导查单或联系客服
重试过程必须可取消 & 有明确状态反馈
用户可能中途关闭页面、切走 Tab 或点击“取消支付”，此时所有重试任务必须立即终止，防止后台静默执行。
- 对外暴露
abort()方法，UI 层可绑定按钮或监听页面卸载事件：window.addEventListener('beforeunload', () => retryTask.abort()) - 界面上显示明确状态：“正在尝试重新提交…（1/2）”，避免用户重复点击“支付”按钮
- 成功后立即跳转或弹窗提示；最终失败则展示结构化错误信息（如“网络不稳定，请稍后在订单页查看支付结果”）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
