Flutter应用内购切换至支付App后状态丢失重启问题求助

一、解决应用间切换的状态保留问题 #

1. 关键状态本地持久化 #

将内购流程中的核心数据（如订单ID、当前购买步骤、商品ID）提前存储到本地（推荐shared_preferences或Hive），彻底避免依赖内存状态：

// 发起内购时存储订单ID
final prefs = await SharedPreferences.getInstance();
await prefs.setString('current_purchase_order_id', orderId);

// PurchaseScreen初始化时恢复状态
@override
void initState() {
  super.initState();
  _restorePurchaseState();
}

void _restorePurchaseState() async {
  final prefs = await SharedPreferences.getInstance();
  final orderId = prefs.getString('current_purchase_order_id');
  if (orderId != null) {
    // 恢复购买流程，比如查询订单状态
    _checkPurchaseStatus(orderId);
  }
}

2. 优化Android Activity配置 #

在android/app/src/main/AndroidManifest.xml的MainActivity中添加配置，减少因系统配置变更导致的Activity重启：

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|screenSize|screenLayout|keyboardHidden|smallestScreenSize|uiMode"
    ...>

3. 监听App生命周期触发状态恢复 #

通过WidgetsBindingObserver监听应用前后台切换，回到前台时主动触发状态恢复逻辑：

class PurchaseScreen extends StatefulWidget {
  @override
  _PurchaseScreenState createState() => _PurchaseScreenState();
}

class _PurchaseScreenState extends State<PurchaseScreen> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.resumed) {
      // 应用回到前台，检查并恢复购买状态
      _restorePurchaseState();
    }
  }

  // ... 其他业务方法
}

二、可靠追踪支付状态 #

1. 基于订单ID主动查询 #

不管应用是否重启，都用持久化的订单ID直接调用支付平台的查询接口：

• Android：使用BillingClient的queryPurchasesAsync查询已购商品
• iOS：通过SKPaymentQueue.default().transactions获取交易记录

2. 依赖后端验证（推荐） #

将支付验证逻辑放在后端服务器，彻底规避客户端状态丢失风险：

1. 发起内购时，后端生成唯一订单ID并返回给客户端
2. 支付完成后，客户端将支付凭证发送给后端
3. 后端向Google Play/App Store验证凭证有效性，更新订单状态
4. 客户端重启后，直接从后端拉取订单状态，无需依赖本地内存

3. 全局监听支付交易队列 #

在应用启动时就初始化支付客户端并注册全局监听，确保即使应用重启也能接收支付回调：

// 示例：Google Play BillingClient全局监听
class BillingService {
  late BillingClient _billingClient;

  void init() {
    _billingClient = BillingClient.newBuilder(context)
        .setListener((BillingResult result, List<Purchase>? purchases) {
          // 处理支付结果，更新本地状态和后端数据
          if (purchases != null && purchases.isNotEmpty) {
            _handlePurchases(purchases);
          }
        })
        .enablePendingPurchases()
        .build();

    _billingClient.startConnection((BillingResult result) {
      if (result.responseCode == BillingResponseCode.OK) {
        // 连接成功，查询已有购买记录
        _billingClient.queryPurchasesAsync(
          QueryPurchasesParams.newBuilder()
              .setProductType(BillingClient.ProductType.INAPP)
              .build(),
          (BillingResult result, List<Purchase> purchases) {
            _handlePurchases(purchases);
          },
        );
      }
    });
  }
}

三、关于问题本质的说明 #

这并非Flutter的已知bug，而是移动端系统的通用行为：当应用进入后台且系统内存不足时，会被系统杀死进程，再次唤起时会冷启动。因此永远不能依赖内存中的状态来保存关键业务数据，必须通过持久化+后端验证的方式保障流程完整性。

Flutter官方内购文档也明确推荐了这种持久化+后台验证的方案，是跨平台内购的标准实践。

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