iOS应用内购出现SKPaymentQueue错误码4097的原因及解决方法

你遇到的具体错误日志：

return (<SKPaymentQueue: 0x281d5ccc0>: Error in remote proxy while processing transaction: Error Domain=NSCocoaErrorDomain Code=4097 "connection to service with pid 60667 named com.apple.storekitd" UserInfo={NSDebugDescription=connection to service with pid 60667 named com.apple.storekitd}
)

错误成因 #

• 系统服务不稳定：com.apple.storekitd是iOS专门处理内购的后台服务，偶尔会因为系统资源紧张、服务意外崩溃重启，或者进程间通信（IPC）超时，导致APP和它的连接中断，4097就是IPC连接失败的通用错误码。
• 应用状态切换干扰：如果用户在购买流程中快速切后台、锁屏，或者系统后台清理资源时，storekitd的连接可能被强制切断，触发这个错误。
• 流程时序问题：如果还没等SKProductsRequest的回调完成就发起购买，或者短时间内重复发起购买请求，容易导致服务端连接混乱，引发错误。

预防与修复方法 #

• 增加错误重试逻辑：捕获到这个4097错误时，别直接提示用户失败，间隔1-2秒后重试购买流程（最多重试2-3次，避免无限循环），大部分情况下重试就能恢复连接。
• 严格控制购买时序：必须等SKProductsRequest返回商品信息后，再允许用户点击购买；同时给购买按钮加“点击锁”，比如点击后禁用按钮直到流程结束，避免短时间内重复发起请求。
• 监听应用状态，重连支付队列：在APP从后台切回前台时，重新给SKPaymentQueue添加观察者（SKPaymentQueue.default().add(self)），确保和storekitd的连接状态正常。
• 及时清理无效交易：定期调用SKPaymentQueue.default().finishTransaction(_:)处理队列里所有未完成的交易，避免堆积无效交易导致服务异常。
• 适配系统版本：iOS13到14的部分版本存在storekitd稳定性问题，尽量适配最新iOS系统，同时针对低版本做兼容处理，比如增加更多错误判断分支。

内容的提问来源于stack exchange，提问作者Alê Oliveira