TestFlight环境下React Native iOS应用内购问题排查

可能的原因及修复步骤 #

1. 签名与权限配置问题 #

TestFlight安装包的签名逻辑和Xcode开发安装不同，容易出现权限不匹配：

• 归档时确认签名证书选择「App Store」或「Ad Hoc」，且对应的Provisioning Profile已启用应用内购权限，重新生成Profile后重新归档上传。
• 检查Info.plist中是否遗漏NSAppleMusicUsageDescription等内购相关权限描述（部分场景下会影响验证流程）。

2. 应用内购商品状态与版本关联问题 #

即使商品显示「Ready to Submit」，也可能存在配置遗漏：

• 进入App Store Connect，确认内购商品已关联到当前TestFlight测试的应用版本。
• 检查商品的本地化描述、价格层级是否配置完整，未完成的项会导致沙箱验证失败。

3. 沙箱账号与商品区域不匹配 #

• 沙箱测试账号的区域必须和内购商品设置的可用区域完全一致，区域不符会触发持续登录弹窗，更换对应区域的沙箱账号重试。
• 确保设备上未同时登录生产Apple ID和沙箱账号，两者会导致验证逻辑冲突。

4. React Native内购库的环境配置错误 #

如果使用react-native-iap等第三方库，需确认环境切换逻辑：

• TestFlight属于Release环境，部分库不会自动切换到沙箱，需手动指定：

  import { Platform } from 'react-native';
  import { initConnection, setStoreKitConfiguration } from 'react-native-iap';
  
  if (Platform.OS === 'ios' && !__DEV__) {
    setStoreKitConfiguration({ environment: 'Sandbox' });
  }
  await initConnection();
  

• 验证收据时必须使用沙箱地址：https://sandbox.itunes.apple.com/verifyReceipt，禁止在TestFlight环境调用生产验证地址。

5. 系统沙箱缓存残留 #

• 卸载TestFlight应用后，进入iOS设置的「App Store」底部退出所有登录的Apple ID，重启设备后再重新安装并登录沙箱账号。

6. 收据验证逻辑错误 #

• 检查验证失败的回调逻辑，避免无限触发登录请求（比如不要在验证失败时直接调用登录方法，而是提示用户检查账号或重试）。
• 确保正确处理沙箱收据的返回结果，沙箱验证的返回码和生产环境有差异，需单独适配。

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