iOS归档构建及TestFlight环境下IAP返回0个商品问题

• 开发环境：Swift 5
• 业务场景：接入自动续期订阅类型的App内购买（IAP）
• 异常表现：
  • Scheme勾选Debug executable时可正常拉取商品信息
  • 取消勾选Debug executable时，商品请求返回0个结果
  • 归档后上传至TestFlight的包，同样无法获取对应商品
• 当前商品拉取逻辑实现：

// MARK: - SKProductsRequestDelegate
extension IAPManager: SKProductsRequestDelegate {
    public func productsRequest(_ request: SKProductsRequest, didReceive response: SKProductsResponse) {
        print("Loaded list of products...")
        let products = response.products
        guard !products.isEmpty else {
            print("Product list is empty...!")
            print("Did you configure the project and set up the IAP?")
            productsRequestCompletionHandler?(false, nil)
            return
        }
        productsRequestCompletionHandler?(true, products)
        clearRequestAndHandler()
        for p in products {
            print("Found product: \(p.productIdentifier) \(p.localizedTitle) \(p.price.floatValue)")
        }
    }
}

按优先级逐一验证：

1. 补全错误日志
   现有代码仅判断了商品列表是否为空，没有打印无效商品ID字段，首先在回调方法最开头加一行日志：

   print("Invalid product identifiers: \(response.invalidProductIdentifiers)")
   

   只要该数组不为空，就说明传入的商品ID本身存在问题，可直接定位根因。

2. 核对IAP基础配置

   • 确认App Store Connect中自动续期订阅产品的所有必填项已全部完成：包括归属订阅群组、定价、所有地区的本地化标题/描述、审核信息，产品状态不能为「准备提交」「元数据缺失」「被拒绝」
   • 确认代码中传入的商品ID与App Store Connect配置的ID完全一致，大小写、特殊字符、前后空格完全匹配
   • 确认App Store Connect的「协议、税务和银行」板块中，付费应用协议已签署完成、税务和银行信息已审核通过，状态为「有效」——该状态异常时，所有非Xcode注入调试环境的IAP请求都会返回空。

3. 修复环境差异问题

   • 未勾选Debug executable时，Xcode不会自动注入StoreKit调试上下文，测试设备需要手动在系统「设置」-「App Store」-「沙盒账户」入口登录有效的沙盒测试账号，否则请求会落到正式环境，刚创建的沙盒产品在正式环境无法查询到
   • 检查本地StoreKit配置文件的关联范围：如果调试时用了本地.storekit配置文件模拟商品，确认Release/Archive配置没有关联该本地文件，同时线上IAP配置已经同步完成——苹果服务器的IAP配置最长需要24小时同步到全球所有节点，刚创建的产品立刻打TestFlight包大概率拉取不到，等待同步完成即可
   • 检查Release构建配置的能力项：在项目「Signing & Capabilities」页确认In-App Purchase能力在Release配置下同样处于开启状态，没有被条件编译或构建配置屏蔽，确认Release配置下已正确引入StoreKit框架。

4. TestFlight包特殊校验

   • 确认上传TestFlight的包使用App Store/Ad Hoc类型的Distribution证书签名，不要用Development证书做归档构建
   • TestFlight环境测试IAP不需要手动登录沙盒账号，直接用TestFlight邀请的测试账号登录App Store即可，不要混用沙盒账号和正式Apple ID测试。

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