Flutter Toast消息在VS Code中异常：仅热重启后正常显示

问题现象 #

仅VS Code调试时出现异常：使用已注册邮箱走Firebase注册流程，点击注册按钮后错误仅输出到控制台，前端Toast完全不显示；执行Hot Restart后，Toast才会短暂弹出。Android Studio中无此问题。

可能原因 #

1. Fluttertoast依赖原生平台实现，VS Code调试环境下，Firebase错误回调未在Flutter主UI线程执行，导致Toast无法及时渲染；热重启后UI线程状态重置，Toast才得以触发。
2. 当前代码先调用Toast再更新loading状态，UI状态更新可能干扰Toast的显示逻辑。
3. VS Code调试桥接对原生Toast的支持存在延迟或上下文丢失。

解决方案 #

方案1：强制Toast在主UI线程执行 #

修改utils.dart，通过SchedulerBinding确保Toast代码在主UI队列执行：

import 'package:flutter/material.dart';
import 'package:fluttertoast/fluttertoast.dart';
import 'package:flutter/scheduler.dart';

class Utils {
  static void toastMessage(String message) {
    SchedulerBinding.instance.addPostFrameCallback((_) {
      Fluttertoast.showToast(
        msg: message,
        toastLength: Toast.LENGTH_LONG,
        gravity: ToastGravity.CENTER,
        backgroundColor: Colors.red,
        textColor: Colors.white,
        fontSize: 16.0,
        timeInSecForIosWeb: 1,
      );
    });
  }
}

方案2：换用纯Flutter实现的提示库（推荐） #

你已导入flutter_flushbar，该库基于Flutter Overlay实现，完全不依赖原生Toast，能避免平台适配问题：
更新utils.dart：

import 'package:flutter/material.dart';
import 'package:flutter_flushbar/flutter_flushbar.dart';

class Utils {
  static void showErrorToast(BuildContext context, String message) {
    Flushbar(
      message: message,
      backgroundColor: Colors.red,
      textColor: Colors.white,
      duration: const Duration(seconds: 3),
      flushbarPosition: FlushbarPosition.TOP,
    ).show(context);
  }
}

在signup_screen.dart的错误回调中传递context：

.onError((error, StackTrace) {
  Utils.showErrorToast(context, error.toString());
  setState(() {
    loading = false;
  });
});

方案3：重构认证代码为async/await风格 #

改用async/await处理异步操作，错误逻辑更清晰，减少回调线程问题：
修改signUp方法：

Future<void> signUp() async {
  setState(() {
    loading = true;
  });
  try {
    await _auth.createUserWithEmailAndPassword(
      email: emailController.text.toString(),
      password: passwordController.text.toString(),
    );
  } on FirebaseAuthException catch (e) {
    Utils.toastMessage(e.message ?? '注册失败');
  } catch (e) {
    Utils.toastMessage(e.toString());
  } finally {
    setState(() {
      loading = false;
    });
  }
}

额外排查步骤 #

• 检查fluttertoast版本是否适配当前Flutter SDK，建议升级到最新稳定版。
• 执行flutter clean清除缓存后重新运行项目，排除调试状态异常。

内容的提问来源于stack exchange，提问作者Shahzain Ahmed