在iOS应用内购（IAP）的沙盒测试中，交易一直挂起是许多开发者都会碰到的棘手问题。具体表现为用户完成支付后，客户端没有收到明确的成功或失败回调，或者收到了purchased状态却因为逻辑遗漏而没有结束交易，导致SKPaymentQueue里始终保留着未完成的订单。这种挂起不仅让当前测试卡住，还会影响同一个沙盒账号的后续购买。
为什么沙盒测试会出现交易挂起
交易挂起的根本原因往往出在观察者回调的处理不完整。苹果要求开发者在SKPaymentTransactionObserver的paymentQueue:updatedTransactions:方法中，对所有非deferred状态的交易调用finishTransaction。如果只处理了部分分支，比如只处理了failed而忘了purchased，那么已支付的交易就会留在队列中，系统会认为这笔交易还没被应用确认。
另一个常见情况是网络或调试中断。沙盒环境本身不稳定，若在回调刚触发时断点调试过久，或者App在finishTransaction之前被杀死，交易状态就无法正常清除。当下次启动App并再次添加观察者时，系统会重新抛出同一笔挂起交易，若代码仍不处理，就会陷入循环。
SKPaymentQueue与finishTransaction的作用
SKPaymentQueue是苹果内购的交易队列管理器，每一笔发起的购买都会进入这个队列，由系统按顺序通知观察者。finishTransaction方法的意义在于告诉苹果：应用已经妥善保存了这笔交易的凭证或权益，系统可以把它从队列里移除。只有调用了该方法，挂起状态才会真正解除。
从技术角度看，不调用finishTransaction并不会让苹果退款，但会让这笔交易在设备上一直处于待处理。对于沙盒测试账号来说，未结束的交易越多，后续弹窗和报错就越频繁。因此强制结束的核心逻辑就是：无论成功失败，只要不是等待用户确认的状态，都必须finish。
强制结束挂起交易的具体代码实践
在Observer的实现中，应当遍历updatedTransactions传来的数组，针对每一个transaction判断状态。下面是一段典型且安全的处理结构：
- SKPaymentTransactionStatePurchased：验证凭证后调用finishTransaction
- SKPaymentTransactionStateFailed：直接finishTransaction，避免错误订单残留
- SKPaymentTransactionStateRestored：恢复购买后finishTransaction
- SKPaymentTransactionStateDeferred：不处理，等待家长批准等后续回调
如果已经发生挂起，可以在App启动添加观察者之后，主动去currentQueue的transactions里检查。对于状态为purchased或failed的历史交易，直接补一次finishTransaction即可强制清理。示例逻辑为：遍历[SKPaymentQueue defaultQueue].transactions，若transaction.transactionState不等于SKPaymentTransactionStatePurchasing且不等于Deferred，就调用[[SKPaymentQueue defaultQueue] finishTransaction:transaction]。
需要注意的避坑点
第一，finishTransaction必须在主线程调用，否则可能引发队列状态异常。第二，不要在还没完成权益下发时就提前finish，虽然能解挂起，但可能导致用户付了钱没拿到商品。第三，沙盒账号可在设置中的App Store沙盒管理里手动清除购买历史，作为代码之外的辅助手段。
用表格对照不同状态的处理方式
| 交易状态 | 是否需finish | 说明 |
|---|---|---|
| purchasing | 否 | 正在处理，等待系统回调 |
| purchased | 是 | 已支付，发权益后强制结束 |
| failed | 是 | 失败也要结束，防止堆积 |
| restored | 是 | 恢复购买完成即结束 |
| deferred | 否 | 等待外部决策，暂不处理 |
总结与测试建议
面对iOS内购沙盒测试交易挂起，最稳妥的方案就是保证Observer里对每个终态交易都调用SKPaymentQueue的finishTransaction。开发阶段可专门写一段启动时的队列清理代码，把遗漏的旧交易强制结束，能大幅减少测试阻塞。同时养成在真机沙盒和TestFlight中分阶段验证的习惯，避免上线后因为同样的逻辑缺失造成用户客诉。
只要理解队列机制和终态必须finish的原则，这类挂起问题完全可以控制在开发期内解决，不会演变成难以排查的线上故障。
iOS内购沙盒测试SKPaymentQueuefinishTransaction修改时间：2026-08-11 03:51:25