需即时反馈场景下SAGA模式的应用与用户交互难题求解

针对你遇到的SAGA模式下事务一致性与用户体验的矛盾问题，可通过以下分层方案解决：

一、前置同步校验拦截即时领域错误 #

既然外部商户API常返回即时领域错误（用户未注册、停用、金额超限等），在执行钱包扣款前先同步调用商户的轻量预校验接口：

• 预校验接口仅做参数合法性、用户状态、金额限制等快速检查，不产生实际采购行为
• 若预校验失败，直接将具体错误信息同步返回给用户，无需进入后续SAGA流程
• 预校验通过后，再执行钱包扣款+异步SAGA采购流程，此时用户看到的提示是「订单已提交，正在处理中」，不会出现前后矛盾的情况

二、异步流程的用户状态反馈机制 #

1. 订单ID+前端轮询兜底 #

• 用户发起请求后，同步返回唯一订单ID，前端立即根据该ID轮询后端订单状态接口
  • 轮询策略：前5次每3秒一次，之后每10秒一次，最多轮询5分钟；超过时间仍无结果则提示「订单处理超时，请稍后查看订单列表」
• 同时后端通过webhook/websocket推送状态更新，但轮询作为兜底方案，避免推送失败导致用户无感知

2. 细化订单状态，避免模糊提示 #

订单表需记录全流程状态，前端根据状态展示精准提示：

• 预校验中：仅在同步阶段短暂显示
• 钱包扣款成功：同步返回时的初始状态
• 采购请求发起中：异步调用商户API时的状态
• 采购成功：最终成功状态
• 退款中：采购失败后的补偿流程状态
• 退款完成：补偿完成状态
• 采购失败（具体原因）：商户返回明确错误后的状态（如「金额超限」「用户未注册」）

3. 多渠道主动通知 #

对于异步流程的最终结果，除了页面反馈，还需通过多渠道通知用户：

• APP推送/站内信（针对APP用户）
• 短信通知（针对未登录用户）
• 通知内容需包含订单ID、结果、金额变动（如「您的订单XXX采购失败，已为您退款XX元」）

三、防重复提交机制 #

解决用户重复发起请求的问题：

• 前端：按钮点击后置灰，禁用重复提交
• 后端：生成用户ID+商品ID+金额的唯一请求标识，存入Redis并设置15分钟有效期；重复请求直接返回「请求已在处理中，请稍后查看订单状态」

四、SAGA流程的一致性保障 #

• 每个SAGA步骤（扣款、采购、退款）需保证幂等性：比如扣款前检查订单状态，退款前确认是否已退款
• 异步消费失败时采用指数退避重试（如1分钟、3分钟、5分钟后重试），重试3次仍失败则标记订单为「待人工处理」，同时触发告警通知运营人员介入
• 所有SAGA操作需记录详细日志，包含操作时间、状态、错误信息，便于排查问题

内容的提问来源于stack exchange，提问作者MistaOS