发生了什么
会员是一种付费订阅:用户在会员页选一个套餐,付完钱,账户上的会员到期时间就往后延一段。为了收这笔钱,系统会先给这次购买生成一张会员订单,订单在一段时间内处于待支付;用户选好支付方式、在支付渠道里完成付款,支付结果回来之后,订单才变成已支付,会员时长才加上去。
如果用户在付款过程中主动退出或者放弃,页面会走取消处理:把这张订单关掉,同时清掉那条待支付记录,免得留下一张永远等不到付款的单。所以“关单”这个动作本身是有用的,它只应该在确认用户不再付钱的时候发生。
这套页面是一份 H5 代码,被装进好几个容器里跑:应用内嵌的页面、普通手机浏览器、支付宝和微信内置的浏览器,以及微信小程序。每个容器能直接调起的支付方式不一样。在微信小程序里,页面自己调不起微信支付,需要跳到小程序里完成付款,付完再回跳到页面。跳出去之后,这个页面随时可能被销毁或冻结,所以这段代码有意停在这里等:它不给调用方任何结果,让调用方一直挂着,后续交给回跳逻辑接管。这是设计,不是漏写返回值。
上一版只覆盖了内嵌页面里的支付宝和微信普通支付。这一版要把普通支付和自动续费同时铺到内嵌页面、普通浏览器、支付宝浏览器、微信浏览器和微信小程序。这次改动在评审时,那段“永远不给结果”的写法被列成一条需要修掉的问题。改这一段的时候,它被换成了主动抛出一个错误,错误文案写着“已取消支付”。
结果是在微信小程序里买会员、选微信支付,一点下去页面立刻报错:这笔订单被判成用户取消,订单关掉、待支付记录清空,用户付不了款。业务反馈之后,这个前端分支已经回滚。受影响的用户数和订单量,记录里没有统计。
本质
一句话:一段“有意挂起、等端外接管”的等待被改成抛异常,而异常文案正好落进“用户取消”的关单分支。
- 原流程:进入微信小程序渠道时,页面把付款交给小程序,自己返回一个永不完成的任务。调用方因此挂起,既不关单也不清待支付记录,因为用户此刻可能正在付款。
- 改动:评审把这种写法当成缺陷,改的人把它换成一个主动抛出的错误,文案写成“已取消支付”。这一步只看了代码形式,没有确认这个“永不完成”是刻意设计的。
- 上层处理:支付调用外面有一层统一的取消与错误处理,它靠错误文案里有没有“已取消支付”来判断是不是用户自己放弃付款。这个分支的职责是识别用户取消,并据此关单。
- 误判:于是这句由页面自己抛出的文案命中了取消分支,被包装成“支付已取消”的异常,外层接着执行关单、清掉待支付记录。
- 结果:用户还在小程序里付款,或者刚付完准备回跳,页面这一侧的订单已经关了、待支付记录也没了;回跳回来找不到可以继续的单,页面报错。
用错误文案表达“把控制权交给端外”,等于让一次正常的挂起走进了“用户取消”的关单路径。这次的处理是把该分支回滚成原来的永不完成写法。想彻底避免同类问题,修复方向是:取消和失败用不同的异常类型或显式信号区分,处理层按类型分支,不再按错误文案匹配;同时给这段挂起补一句注释,写清它的用途和由谁接管。记录里没有这两项改动,属于建议。
下面的 Java 代码是按上述机制写的教学示例:用“永不完成的任务”对应为跳转端外而挂起,用“失败的任务 + 错误文案”对应改成抛异常,用于对照两种写法在取消分支上的差别,不代表实际项目源码或已上线实现。
错误代码
public class VipPayService {
// 微信小程序渠道发起支付:跳到小程序付款,付完再回跳
public CompletableFuture<PayResult> payByMiniProgram(VipOrder order) {
// 原实现 return new CompletableFuture<>(); 一直不完成,调用方挂起等回跳接管
// 为什么错:把“有意挂起”改成失败任务,文案还写成“已取消支付”
return CompletableFuture.failedFuture(new IllegalStateException("已取消支付"));
}
public CompletableFuture<PayResult> submit(VipOrder order) {
return payByMiniProgram(order)
.thenApply(result -> markPaid(order, result))
.exceptionally(e -> handleCancelOrError(order, e));
}
private PayResult handleCancelOrError(VipOrder order, Throwable e) {
// 为什么错:按错误文案判断“用户取消”,自己刚抛的异常正好命中了这一支
if (e.getMessage() != null && e.getMessage().contains("已取消支付")) {
closeVipOrder(order); // 用户还在端外付款,订单先被关掉
clearPendingOrder(order); // 待支付记录被清掉,回跳后找不到可用的单
throw new PaymentCancelledError(e);
}
throw new PayFailedError(e);
}
}
修复代码示例
public class VipPayService {
public CompletableFuture<PayResult> payByMiniProgram(VipOrder order) {
// 修复:改回有意挂起。跳转小程序后本页即将被销毁或冻结,
// 这个任务永远不完成就是正确行为,由端外支付完成后的回跳逻辑接管这笔单
return new CompletableFuture<>();
}
public CompletableFuture<PayResult> submit(VipOrder order) {
return payByMiniProgram(order)
.thenApply(result -> markPaid(order, result))
// 上面的任务不完成,这条取消处理就不会被触发,关单只等真实取消信号
.exceptionally(e -> handleCancelOrError(order, e));
}
}
下次遇到这些场景要警惕
- 看到“永不返回、永不完成”的写法时:先找出谁在等它、等待结束后由谁接管,再判断它是不是缺陷。改之前把“交出控制权”和“失败”当成两种语义,不能只按代码形式判错。
- 支付、下单流程里出现取消处理时:确认取消是靠什么识别的。靠错误文案或字符串匹配识别的,把所有可能带这句话的抛错点列出来,逐个确认这次关单是否应该发生。
- 改完支付渠道分支后:用每个容器各走一遍“正常付完、用户主动放弃、跳转端外再回跳”三种路径,重点看挂起期间订单状态和待支付记录有没有被提前改掉。
- 采纳评审建议前:对“永不 resolve、空实现、兜底返回”这类写法,先问清原作者意图和调用方的依赖,再决定改法;只按规则套用,容易把有意设计当成缺陷改坏。