·更新于 2026年11月22日· 157 次浏览 支付系统Node.jsMongoDBRedis微信小程序NuxtVue3BUG解决工程实践开发经验

支付退款卡在“退款中”不动:我用主动查询、补偿任务和幂等状态机修好回调丢失

一次微信小程序退款回调丢失,让订单卡在退款中。本文复盘如何用主动查询、补偿任务和幂等状态机,把不可靠通知改成可恢复、可对账的退款闭环。

支付退款卡在“退款中”不动:我用主动查询、补偿任务和幂等状态机修好回调丢失 封面
ZHOUYI

作者

ZHOUYI

那天客服转来一张截图:用户在小程序里发起退款,半小时后仍显示“退款中”。我们用 Nuxt 做后台页面,日志里也确实调用了退款接口,但一直没等到回调。刚开始我以为是网络抖动,后来发现支付侧其实已经推进,只是我们没有收到通知。问题不在于回调丢失,而在于我们把最终状态押在异步通知上,缺少主动恢复能力。

用状态机管住退款单

我把退款单当成一个状态机,而不是一条普通业务记录。状态只允许 INIT、PROCESSING、SUCCESS、FAIL 四种,任何变更都要记录来源、时间和原因。这样客服能解释当前卡在哪里,程序也能判断下一步该查询、重试还是转人工。

  • 每次退款用 refundNo 做幂等键,重复请求直接返回已有退款单。
  • 回调、主动查询、补偿任务都调用同一个 handleRefundResult 方法,避免多套更新逻辑。
  • 状态推进必须带旧状态条件,防止并发覆盖。

主动查询和补偿任务

提交退款后,我不再干等回调,而是立刻把单据置为 PROCESSING,并投递延迟查询任务。补偿任务再定时扫描超过阈值仍未终态的退款单。这样即使某次回调丢失、延迟任务失败,也还有最后一道兜底。

javascript
async function syncRefund(refundNo) {
  const lockKey = `refund:lock:${refundNo}`;
  if (!(await redis.set(lockKey, '1', 'EX', 30, 'NX'))) return;
  const remote = await pay.queryRefund(refundNo);
  if (remote.status === 'SUCCESS' || remote.status === 'FAIL') {
    await db.collection('refunds').updateOne(
      { refundNo, status: 'PROCESSING' },
      { $set: { status: remote.status, updatedAt: new Date() } }
    );
  }
  await redis.del(lockKey);
}

踩坑与对账

  • 回调可能晚到或重复:如果退款单已是终态,直接返回成功,不再改状态。
  • 查询结果比回调更适合作为推进依据,但金额、单号、商户号必须校验一致。
  • 每天用支付侧退款单和本地流水对账,差异单进入人工核查队列。
  • 不要把广告曝光、流量统计这类旁路逻辑塞进退款主链路,先保证资金状态可解释。

“可靠不是相信某一次回调,而是任何一环丢失后,系统还能自己恢复。”

修复后,“退款中”不再是一个黑盒状态,而是一个可查询、可补偿、可追责的中间态。前端 Vue3/Nuxt 只是展示状态,真正要稳的是服务端闭环。现在再遇到退款卡住,后台能查到支付侧状态,任务能自动补齐,财务也能对账。这类问题从惊悚事故变成了可观测的日常运维。

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?