Flutter中使用flutter_inapp_purchase获取iOS购买历史返回空数组求助

一、flutter_inapp_purchase iOS端获取订阅历史失败的核心原因 #

iOS端订阅历史查询的配置与校验逻辑比Android更严格，即便添加了Apple Pay能力，仍可能存在以下问题：

• App Store Connect中旧订阅产品已被删除：iOS依赖产品ID关联历史订阅记录，一旦删除旧订阅项目，服务器将无法返回对应历史数据
• 未捕获调用异常：你的代码没有错误捕获逻辑，无法定位具体失败原因（比如网络问题、服务器返回错误、权限限制等）
• 沙盒环境测试限制：沙盒账号的订阅会自动过期，过期后无法查询到历史记录；生产环境需使用正式上架后的账号测试

二、能否继续使用flutter_inapp_purchase完成需求？ #

可以，先通过以下步骤修复：

1. 添加错误捕获排查问题
   修改代码捕获异常，明确失败原因：

Future _getPurchaseHistory() async {
  try {
    await FlutterInappPurchase.instance.initialize();
    List<PurchasedItem>? items = await FlutterInappPurchase.instance.getPurchaseHistory();
    setState(() {
      _purchases = items ?? [];
      _items = [];
    });
  } catch (e) {
    print('获取订阅历史失败：$e');
    // 根据错误信息针对性修复，比如权限、网络或配置问题
  }
}

2. 确认App Store Connect配置
   保留旧版本的订阅产品（不能删除），确保Bundle ID、产品ID与当前应用完全一致
3. 验证测试环境

• 沙盒测试：使用有有效订阅记录的沙盒账号，且订阅未过期
• 生产测试：使用正式上架后的应用账号，确保网络能正常连接App Store服务器

三、替代实现方案 #

如果flutter_inapp_purchase仍无法解决问题，可切换到Flutter官方维护的in_app_purchase插件，其对iOS订阅逻辑的支持更稳定：

1. 添加依赖到pubspec.yaml：

dependencies:
  in_app_purchase: ^3.1.10

2. 查询历史订阅的示例代码：

import 'package:in_app_purchase/in_app_purchase.dart';

Future<void> _getPastSubscriptions() async {
  final QueryPurchaseDetailsResponse response = await InAppPurchase.instance.queryPastPurchases();
  if (response.error != null) {
    print('查询失败：${response.error}');
    return;
  }
  // 过滤出目标订阅类型的历史记录
  final List<PurchaseDetails> subscriptions = response.pastPurchases.where((purchase) {
    return purchase.productID == '你的旧订阅产品ID';
  }).toList();
  setState(() {
    _purchases = subscriptions;
  });
}

关键提醒 #

无论使用哪个插件，绝对不能删除App Store Connect中的旧订阅产品，这是iOS端能查询到历史订阅记录的核心前提。

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