Swift调用presentCodeRedemptionSheet()无法弹出内购优惠码兑换页问题

按优先级从高到低排查修复，90%以上的不弹出问题都是前三个原因导致：

• 主线程调用缺失：StoreKit所有和UI呈现相关的API必须在主线程执行，哪怕你是在按钮点击回调里触发，也可能因为按钮点击事件的传递链路问题不在主线程，必须显式切到主线程调用，后台线程调用会静默失败无任何日志。
• 测试环境不符合要求：
  • 该方法在iOS模拟器上完全无效，必须使用真机测试
  • iOS14系统的沙盒调试环境不支持唤起该兑换页，仅TestFlight包、App Store正式包可在iOS14上正常触发；iOS15及以上系统的沙盒环境才支持直接唤起
• 交易观察者未配置：必须在App启动阶段就给SKPaymentQueue添加遵守SKPaymentTransactionObserver协议的观察者，不能等到用户点击按钮时才添加。未配置观察者时，系统会判定应用不具备处理内购交易的能力，直接拦截兑换页弹出。
• 前台状态冲突：触发方法时App必须处于active前台状态，若当前有其他系统弹窗（如权限申请弹窗、Apple ID密码输入框）、应用刚启动还没完成加载、或者多Scene场景下前台Scene不对，都会导致弹窗失败。
• API版本兼容性问题：iOS16+推荐使用StoreKit 2的原生兑换API，比旧版StoreKit API的弹窗稳定性高很多，不会出现场景找不到的问题。

修正后可直接复用的代码 #

1. 启动时配置交易观察者（AppDelegate内添加） #

import StoreKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate, SKPaymentTransactionObserver {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 应用启动就注册交易观察者，不要延迟注册
        SKPaymentQueue.default().add(self)
        return true
    }

    // 实现交易处理回调，优惠码兑换完成后的交易也会走这个方法
    func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
        transactions.forEach { transaction in
            switch transaction.transactionState {
            case .purchased, .restored:
                // 这里写你解锁对应内购权益的逻辑
                queue.finishTransaction(transaction)
            case .failed:
                // 这里写错误提示逻辑
                queue.finishTransaction(transaction)
            default: break
            }
        }
    }
}

2. 按钮点击唤起兑换页逻辑 #

@IBAction func applyOfferCodeButtonDidPress(_ sender: Any) {
    // 强制切主线程执行UI操作
    DispatchQueue.main.async {
        if #available(iOS 16.0, *) {
            // iOS16+ 用StoreKit 2 API，稳定性更高
            Task {
                try? await AppStore.presentCodeRedemptionSheet()
            }
        } else if #available(iOS 14.0, *) {
            SKPaymentQueue.default().presentCodeRedemptionSheet()
        } else {
            // iOS14以下系统不支持应用内唤起兑换页，跳转到系统兑换入口
            guard let redeemUrl = URL(string: "itms-apps://apps.apple.com/redeem") else { return }
            UIApplication.shared.open(redeemUrl)
        }
    }
}

注意：调用兑换页方法前后不要主动present任何自定义页面，否则会和系统弹窗产生层级冲突，导致兑换页被顶掉无法显示。

内容的提问来源于stack exchange，提问作者Calvin