从iTunes Store获取内购产品时的空错误与未知错误处理问询

问题定位 #

你遇到的两类错误（空对象、errorCode 0的未知错误），核心诱因大概率是屏幕时间禁用内购。这类场景下苹果StoreKit会直接拦截内购请求，不会返回明确的权限错误码，反而抛出模糊的空对象或通用未知错误，这是系统层面的拦截逻辑导致的。

除此之外，还有几个可能的触发场景：

• 用户设备处于离线状态，当前重试逻辑未做网络检测，无效重试只会浪费资源
• 地区限制：部分地区App Store不支持你的内购产品ID
• 内购配置问题：比如ID拼写错误、产品未在Connect后台上架（你用测试ID可排除此条）

有效处理方案 #

1. 前置检测内购权限 #

在调用getProducts前先校验用户内购权限，直接避免无意义的重试：

async checkIapPermission() {
  try {
    const isAllowed = await this.iap.checkPermissions();
    if (!isAllowed) {
      this.showPermissionGuide(); // 提示用户开启内购权限
      return false;
    }
    return true;
  } catch (err) {
    return false;
  }
}

修改getProducts逻辑，先做权限校验：

async getProducts() {
  const hasPermission = await this.checkIapPermission();
  if (!hasPermission) return;

  const productIds = ["svs_halftyer", "svs_monthly"];
  try {
    const res = await this.iap.getProducts(productIds);
    console.log(res);
  } catch (error) {
    if (this.getProductsRetryCount < 5) { // 大幅减少重试次数，权限问题重试无意义
      this.getProductsRetryCount += 1;
      setTimeout(() => {
        this.getProducts();
      }, 1000); // 拉长重试间隔，避免频繁请求被系统拦截
    } else {
      // 针对模糊错误直接引导用户
      if (JSON.stringify(error) === '{}' || (error.errorCode === 0)) {
        this.showPermissionGuide();
      }
      this.saveGetProductsError(error);
    }
  }
}

2. 优化重试逻辑 #

• 增加网络检测：重试前先判断设备是否联网，离线状态直接提示用户
• 动态调整间隔：比如第一次1s、第二次2s、第三次4s，避免短时间重复请求被限流
• 终止无效重试：如果连续3次返回空对象或errorCode 0，直接终止重试并引导用户检查权限

3. 精准错误提示 #

当捕获到空对象或errorCode 0的错误时，直接给出明确引导：

检测到内购权限被限制，请前往「设置-屏幕时间-内容和隐私访问限制-购买项目」开启内购权限

不要用模糊的“未知错误”提示，直接帮用户定位解决路径。

4. 补充排查日志 #

在保存错误时，增加设备信息便于后续排查：

saveGetProductsError(error) {
  const errorInfo = {
    error: error,
    timestamp: new Date().toISOString(),
    deviceInfo: {
      osVersion: this.getOSVersion(), // 可通过第三方库获取系统版本
      deviceModel: this.getDeviceModel() // 获取设备型号
    }
  };
  this.uploadLog(errorInfo); // 上传日志到服务器
}

总结 #

屏幕时间禁用内购是这类模糊错误的核心原因，通过前置权限检测、优化重试逻辑、精准用户提示，可解决大部分问题。补充设备日志则能帮助你排查其他潜在的边缘场景。

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