RevenueCat iOS SDK中用户取消购买状态误报问题解析

问题背景

在iOS应用内购买领域，RevenueCat作为流行的订阅管理解决方案，近期出现了一个影响用户体验的关键问题。开发者在集成RevenueCat iOS SDK（5.4.0及以上版本）时发现，约20%的成功交易被错误地标记为用户取消(userCancelled = true)。这种误报导致应用错误地触发了购物车放弃流程，对业务转化率产生了显著影响。

问题现象

开发者观察到，当用户完成购买流程后，PurchaseResultData中的userCancelled属性被错误地设置为true。这种情况特别出现在Apple引入"续订邮件"确认弹窗后，时间点大约在2025年2月初。从数据上看，约22%的购买流程会触发此问题。

技术分析

深入分析表明，这个问题源于StoreKit框架本身的缺陷。当系统显示"是否接收续订邮件"的确认弹窗时，StoreKit错误地将交易状态返回为"已取消"，而实际上交易仍在后台处理中并最终成功完成。这种状态不一致导致了RevenueCat SDK也返回了错误的取消状态。

值得注意的是，这种错误状态与实际用户取消操作有本质区别：

1. 真实取消：用户主动点击取消按钮，交易立即终止
2. 误报取消：系统弹窗触发，交易仍在后台继续，最终成功

影响范围

该问题具有以下特征：

• 仅影响生产环境，沙盒环境无法复现
• 与iOS 18.3.1及以上版本相关
• 使用StoreKit 2的RevenueCat SDK受影响
• 问题首次出现与Apple引入"续订邮件"弹窗时间吻合

临时解决方案

针对此问题，开发者社区提出了几种临时解决方案：

1. 延迟验证方案：在收到取消状态后，延迟30秒左右再次验证购买状态，因为实际交易成功可能有延迟。

2. 主动同步方案：立即调用syncPurchases()方法强制同步最新购买状态，然后检查entitlements或latestExpirationDate。

3. 混合验证方案：结合上述两种方法，先立即检查，若无结果则设置定时器轮询检查。

示例代码展示了第三种方案的实现：

func handlePurchaseResult(_ result: PurchaseResultData) async {
    if result.userCancelled {
        let maxRetries = 3
        var retryCount = 0
        
        while retryCount < maxRetries {
            try? await Task.sleep(nanoseconds: 10_000_000_000) // 10秒
            let customerInfo = try? await Purchases.shared.syncPurchases()
            
            if let expirationDate = customerInfo?.latestExpirationDate,
               expirationDate > Date() {
                // 实际购买成功
                handleSuccess()
                return
            }
            
            retryCount += 1
        }
        
        // 最终确认是真实取消
        handleRealCancellation()
    } else {
        handleSuccess()
    }
}

长期解决方案

Apple已在iOS 18.4 beta 4中修复了相关StoreKit问题，更新说明中提到："修复了StoreKit API在购买过程中可能返回StoreKit 2域错误的问题"。建议开发者：

1. 鼓励用户升级到iOS 18.4及以上版本
2. 在应用更新说明中提及此问题的修复
3. 保持RevenueCat SDK更新至最新版本

最佳实践建议

为避免类似问题影响用户体验，建议采取以下措施：

1. 购买状态双重验证：重要购买流程应实现客户端和服务端双重验证机制。

2. 优雅的错误处理：对"取消"状态进行智能处理，考虑加入重试机制。

3. 数据分析：建立完善的购买流程监控，及时发现异常模式。

4. 日志完善：确保购买流程有完整的日志记录，便于问题排查。

5. 用户沟通：对于疑似误取消的情况，设计友好的恢复流程。

总结

这次RevenueCat SDK中的购买状态误报问题揭示了iOS内购生态系统的复杂性，特别是当平台引入新功能时可能产生的边缘情况。开发者需要理解，这类问题往往源于底层框架，解决方案需要结合临时规避措施和长期平台更新。通过实施稳健的购买状态处理逻辑和完善的错误恢复机制，可以最大限度地减少对用户体验和业务指标的影响。