Flutter全局函数调用setState()异常及后台SMS处理解决方案

你遇到的核心问题是：后台短信回调是全局函数，直接实例化_TransactionState调用方法时，新创建的State对象并未挂载到Widget树，所以调用setState会报错。以下是两种可行的解决方案，兼顾后台数据更新和前台UI同步：

方案1：全局Stream中转消息 #

通过全局的StreamController在后台回调和State之间传递短信数据，同时配合本地存储处理应用未启动时的消息。

// 全局定义广播流，允许多个监听者
final smsStreamController = StreamController<SmsMessage>.broadcast();

// 后台短信回调函数（必须全局）
Future<void> backgroundMessageHandler(SmsMessage message) async {
  // 发送消息到流中
  smsStreamController.add(message);
  
  // 持久化消息，防止应用未启动时丢失
  final prefs = await SharedPreferences.getInstance();
  final existing = prefs.getStringList('pending_sms') ?? [];
  existing.add(message.body ?? '未知交易短信');
  await prefs.setStringList('pending_sms', existing);
}

class TransactionPage extends StatefulWidget {
  @override
  _TransactionState createState() => _TransactionState();
}

class _TransactionState extends State<TransactionPage> {
  late StreamSubscription<SmsMessage> _smsSubscription;
  List<String> transactionRecords = [];

  @override
  void initState() {
    super.initState();
    // 监听短信流，更新UI
    _smsSubscription = smsStreamController.stream.listen(_processSms);
    // 初始化时加载未处理的后台短信
    _loadPendingSms();
  }

  Future<void> _loadPendingSms() async {
    final prefs = await SharedPreferences.getInstance();
    final pending = prefs.getStringList('pending_sms') ?? [];
    setState(() => transactionRecords.addAll(pending));
    // 清空已加载的缓存
    await prefs.remove('pending_sms');
  }

  void _processSms(SmsMessage message) {
    setState(() {
      transactionRecords.add(message.body ?? '未知交易短信');
    });
  }

  @override
  void dispose() {
    _smsSubscription.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ListView.builder(
      itemCount: transactionRecords.length,
      itemBuilder: (ctx, idx) => ListTile(title: Text(transactionRecords[idx])),
    );
  }
}

方案2：状态管理库统一管理（以Provider为例） #

用全局状态管理类承载交易数据，后台回调更新状态（或缓存到本地），前台通过状态监听自动刷新UI。

// 全局状态管理类
class TransactionStore extends ChangeNotifier {
  List<String> _records = [];
  List<String> get records => _records;

  void addRecord(String content) {
    _records.add(content);
    notifyListeners();
  }

  Future<void> loadCachedRecords() async {
    final prefs = await SharedPreferences.getInstance();
    final cached = prefs.getStringList('cached_transactions') ?? [];
    _records.addAll(cached);
    notifyListeners();
    await prefs.remove('cached_transactions');
  }
}

// 后台短信回调
Future<void> backgroundMessageHandler(SmsMessage message) async {
  final content = message.body ?? '未知交易短信';
  try {
    // 尝试直接更新状态（仅应用在前台时有效）
    final store = Provider.of<TransactionStore>(
      navigatorKey.currentContext!,
      listen: false,
    );
    store.addRecord(content);
  } catch (_) {
    // 应用在后台/未启动时，缓存到本地
    final prefs = await SharedPreferences.getInstance();
    final existing = prefs.getStringList('cached_transactions') ?? [];
    existing.add(content);
    await prefs.setStringList('cached_transactions', existing);
  }
}

// 页面代码
class TransactionPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 初始化时加载缓存数据
    WidgetsBinding.instance.addPostFrameCallback((_) {
      Provider.of<TransactionStore>(context, listen: false).loadCachedRecords();
    });

    return Scaffold(
      body: Consumer<TransactionStore>(
        builder: (ctx, store, child) => ListView.builder(
          itemCount: store.records.length,
          itemBuilder: (_, idx) => ListTile(title: Text(store.records[idx])),
        ),
      ),
    );
  }
}

核心注意事项 #

• 后台回调运行在隔离环境，无法直接访问Widget上下文或未挂载的State对象，必须通过全局流、状态管理或本地存储中转数据。
• 必须处理应用从后台唤醒或启动的场景，读取缓存的短信数据，确保数据不丢失。
• 两种方案都能实现和onMessage完全一致的功能：后台接收短信时更新数据，前台自动同步UI。

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