Expo-IAP 应用内购买问题排查指南

前言

在移动应用开发中，应用内购买(IAP)是常见的盈利模式，但实现过程中往往会遇到各种问题。本文针对 expo-iap 库的使用，提供全面的问题排查指南，帮助开发者快速定位和解决常见问题。

环境准备检查清单

在开始排查问题前，请确保已完成以下基础配置：

iOS 平台准备

1. App Store Connect 配置

   • 完成所有协议、财务和银行信息
   • 创建沙盒测试账户（位于"用户和角色"部分）
   • 确保产品状态为"准备提交"

2. 设备配置

   • 在设备设置中登录沙盒账户（设置 > iTunes 与 App Store）

Android 平台准备

1. Google Play 控制台

   • 完成所有必填信息
   • 添加测试账户到内部测试轨道

2. 构建配置

   • 使用签名版 APK/AAB（非调试构建）
   • 至少上传一个版本到内部测试轨道

常见问题及解决方案

产品列表获取为空

当 getProducts() 返回空数组时，可能的原因及解决方案：

1. 连接未建立

   const { connected, getProducts } = useIAP();
   
   useEffect(() => {
     if (connected) {
       getProducts({ skus: productIds }); // 确保在连接建立后调用
     }
   }, [connected]);
   

2. 产品ID不匹配

   • 确保代码中的产品ID与商店后台配置完全一致
   • 注意大小写和特殊字符

3. 产品未批准（iOS特有）

   • 新创建产品需要等待最多24小时才能生效
   • 确保产品状态为"准备提交"

4. 应用未上传（Android特有）

   • 必须上传签名版本到Play控制台
   • 使用内部测试轨道进行测试

购买流程问题

1. 购买未完成

   • 确保正确处理购买更新和完成交易

   const { currentPurchase, finishTransaction } = useIAP();
   
   useEffect(() => {
     if (currentPurchase) {
       handlePurchase(currentPurchase);
     }
   }, [currentPurchase]);
   
   const handlePurchase = async (purchase) => {
     try {
       const isValid = await validateOnServer(purchase);
       if (isValid) {
         await grantPurchase(purchase);
         await finishTransaction({ purchase }); // 必须完成交易
       }
     } catch (error) {
       console.error('处理购买失败:', error);
     }
   };
   

2. 模拟器限制

   • 应用内购买仅在真实设备上可用
   • 开发时使用 react-native-device-info 检测模拟器环境

连接问题

1. 网络连接错误

   • 实现优雅的错误处理和重试机制
   • 显示用户友好的错误信息

2. 商店服务不可用

   • 处理临时服务中断情况
   • 提供重试选项或备用方案

平台特有问题

iOS 注意事项

1. 产品ID无效

   • 检查沙盒账户登录状态
   • 验证应用Bundle ID匹配

2. StoreKit 配置

   • 在Xcode中添加StoreKit能力
   • iOS 12.x需要添加SwiftUI.framework作为可选框架

Android 注意事项

1. 计费客户端配置

   dependencies {
     implementation 'com.android.billingclient:billing:5.0.0'
   }
   

2. 权限缺失

   <uses-permission android:name="com.android.vending.BILLING" />
   

调试技巧

1. 启用详细日志

   import { setDebugMode } from 'expo-iap';
   
   if (__DEV__) {
     setDebugMode(true);
   }
   

2. 监控连接状态

   const { connected, connectionError } = useIAP();
   
   useEffect(() => {
     console.log('连接状态变化:', { connected, error: connectionError });
   }, [connected, connectionError]);
   

测试策略

1. 分阶段测试

   • 单元测试：模拟购买逻辑
   • 沙盒测试：使用测试账户
   • 内部测试：真实商店环境
   • 生产测试：最终验证

2. 多场景覆盖

   • 成功购买
   • 用户取消
   • 网络错误
   • 余额不足
   • 产品不可用

3. 多设备测试

   • 不同厂商设备
   • 不同操作系统版本

错误代码参考

代码	描述	处理建议
E_USER_CANCELLED	用户取消购买	无需操作
E_NETWORK_ERROR	网络问题	提供重试选项
E_ITEM_UNAVAILABLE	产品不可用	检查产品配置
E_ALREADY_OWNED	已拥有产品	验证所有权状态
E_INSUFFICIENT_FUNDS	余额不足	引导添加支付方式
E_UNKNOWN	未知错误	记录日志调查

结语

应用内购买实现涉及多个环节，需要仔细检查和测试。本文提供的排查指南覆盖了常见问题场景，帮助开发者快速定位问题。遇到复杂问题时，建议从基础配置开始逐步排查，并充分利用调试工具获取详细信息。