沙盒测试时Introductory Offer不显示问题咨询（StoreKit 2）

核心排查与修复步骤 #

1. 确认App Store Connect配置的生效状态 #

• 别光看状态是Ready to Submit，沙盒里Intro Offer得关联到已提交/过审的App版本，或者你得把Intro Offer的配置单独提交审核（哪怕App还没准备好提交）。单纯的Ready状态可能没同步到沙盒服务器。
• 核对订阅组绑定：确保Intro Offer确实挂到了目标自动续期订阅产品上，试用期时长、价格层级没设错。

2. 沙盒缓存与同步延迟处理 #

• 沙盒服务器同步配置最多可能等24小时，刚改完配置别急着测，先等一段时间。
• 强制刷新缓存：设备上走设置 > App Store > 沙盒账户退出账号，重启设备后登全新沙盒号；App里调用SKProduct.refresh()（StoreKit 2接口）主动拉最新产品信息。

3. 修正StoreKit 2的Intro Offer获取逻辑 #

• 必须用StoreKit 2的Product.SubscriptionInfo接口拿Intro Offer，别混用旧StoreKit 1的API。正确示例：

  if let productList = try? await Product.products(for: ["你的订阅ID"]) {
      guard let subscription = productList.first as? Product else { return }
      // 检查是否存在Intro Offer
      if let introOffer = subscription.introductoryOffer {
          // 这里处理UI显示逻辑
          print("Intro Offer可用：\(introOffer.displayPrice)")
      }
      // 验证资格
      if let status = try? await subscription.subscription.status.first, status.isEligibleForIntroOffer {
          // 资格通过，确保UI层没漏掉显示逻辑
      }
  }
  

• 你遇到的isEligibleForIntroOffer返回true但看不到Offer，大概率是UI层没正确判断introductoryOffer是否非空，或者把促销优惠（Promotional Offer）和Intro Offer搞混了。

4. 沙盒订阅重置选项的问题 #

• 重置选项只在买过至少一次该订阅的沙盒账号里显示，得先完成一次订阅购买（哪怕是试用期），再去设置 > [你的App] > 订阅或者App内跳转的管理页查看。
• 全新账号没买过的话，重置选项本来就不会出现。另外可以试试把设备地区切到美国，沙盒在美区的稳定性最好。

5. 其他细节排查 #

• 确保测试设备系统是iOS 15+，StoreKit 2不支持旧系统。
• 核对App的Bundle ID和App Store Connect里的完全一致，沙盒对这个匹配要求很严。
• 绝对要用从没碰过这个订阅产品的全新沙盒账号，哪怕你手动删过订阅记录，沙盒服务器可能还留着资格标记。

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