SwiftUI中.offerCodeRedemption无法识别App Store Connect优惠码求助

问题背景 #

在SwiftUI应用中实现订阅首月折扣的优惠码功能时，通过offerCodeRedemption内置弹窗输入已创建的优惠码，系统提示“无法找到该码”，但直接使用App Store官方兑换链接可正常完成兑换，且优惠码已在App Store Connect及本地StoreKit Configuration文件中配置。

当前代码实现 #

import SwiftUI

struct ContentView: View {
    @State private var showCodeRepemptionSheet = false
    
    var body: some View {
        ScrollView(showsIndicators: false) {
            codeRedemptionButton
            Link(destination: URL(string: "https://apps.apple.com/redeem?ctx=offercodes&id=6737702561&code=TEST2")!, label: {
                Text("Redemption Link")
            })
        }
        .offerCodeRedemption(isPresented: $showCodeRepemptionSheet) { result in
            switch result {
            case .success(let code):
                print("Offer code redeemed: \(code)")
            case .failure(let error):
                print("Offer code redemption failed: \(error)")
            }
        }
    }

    private var codeRedemptionButton: some View {
        Button(action: {
            showCodeRepemptionSheet = true
        }, label: {
            Text("Have a code? Redeem it here.")
        })
    }
}

排查步骤与解决方案 #

1. 确认优惠码类型匹配 #

• offerCodeRedemption弹窗仅支持订阅专属优惠码（Subscription Offer Codes），若创建的是普通App内购买促销码，弹窗无法识别；
• 核对优惠码绑定的订阅产品ID，确保与应用内调用的productID完全一致，无大小写、拼写错误。

2. 验证StoreKit Configuration配置 #

• 打开本地StoreKit Configuration文件：
  • 确认优惠码状态为有效（未过期、未达使用次数上限）；
  • 检查优惠码关联的订阅层级、折扣规则，必须与App Store Connect中的配置完全同步；
  • 确保当前运行Scheme已绑定该配置文件（路径：Scheme -> Edit Scheme -> Run -> Options -> StoreKit Configuration）。

3. 检查测试环境限制 #

• 必须使用沙盒测试账号进行测试，且该账号未兑换过此优惠码（多数优惠码限制单账号仅能兑换一次）；
• 真机测试需退出个人Apple ID，登录沙盒账号；模拟器测试需在设置 -> App Store -> Sandbox Account中登录。

4. 确认弹窗调用逻辑 #

• 确保showCodeRepemptionSheet的状态切换正常（从false变为true时才会触发弹窗）；
• 弹窗需在活跃的视图层级中触发，避免在后台视图、未加载的View或弹窗嵌套中调用。

5. 错误日志精准分析 #

打印失败时的完整错误信息，根据StoreKit.Error细分类型定位问题：

• .offerCodeNotFound：确认优惠码已在App Store Connect中激活（即使测试用码，也需完成发布流程）；
• .offerCodeInvalid：检查优惠码是否过期、已被使用，或与当前用户/设备的订阅状态冲突；
• .offerCodeNotEligible：确认用户符合优惠码的使用条件（如未订阅过该产品、不在其他优惠周期内）。

6. 标准实现流程建议 #

1. 在App Store Connect创建订阅优惠码时，选择“适用于所有用户”或指定测试用户，确保状态为激活；
2. 将优惠码导入本地StoreKit Configuration文件，同步订阅产品信息；
3. 调用弹窗前，确保应用已获取App Store授权（可通过SKCloudServiceController.requestAuthorization()提前请求）；
4. 处理兑换结果时，给用户显示明确的UI提示（如成功弹窗、错误说明），而非仅打印日志。

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