Flutter异步代码块中BuildContext使用问题的解决方案问询

核心原因 #

异步操作（网络检查、凭证验证）执行过程中，当前登录页面可能已被用户退出（比如按返回键），此时原BuildContext关联的Widget已被销毁，继续使用会触发异常。

修改步骤 #

1. 利用State的mounted属性做安全检查：每次需要调用context相关操作（弹窗、导航）前，先判断当前Widget是否仍处于挂载状态。
2. 提前缓存必要实例：避免在异步回调中重复依赖外部context，减少无效调用风险。
3. 添加异常捕获：包裹异步逻辑，避免未处理的异常导致应用崩溃。

修改后的完整代码 #

Container(
  margin: const EdgeInsets.only(right: 10),
  child: ElevatedButton(
    style: ElevatedButton.styleFrom(
      minimumSize: const Size(20, 45),
      backgroundColor: Colors.blue[900],
      foregroundColor: Colors.white,
    ),
    onPressed: () async {
      // 先检查网络连接
      final connectivityResult = await _connectivity.checkConnectivity();
      if (connectivityResult == ConnectivityResult.none) {
        // 确认Widget仍挂载再弹窗
        if (!mounted) return;
        showDialog(
          context: context,
          builder: (ctx) => AlertDialog(
            title: const Text(
              'Oops... ',
              style: TextStyle(fontSize: 22.0),
            ),
            content: const Text(
              '请连接互联网！',
              style: TextStyle(fontSize: 18.0),
            ),
            actions: [
              TextButton(
                onPressed: () {
                  if (!mounted) return;
                  Navigator.pushReplacementNamed(context, StartingScreen.id);
                },
                child: const Text(
                  '确定',
                  style: TextStyle(fontSize: 18.0),
                ),
              ),
            ],
          ),
        );
      } else {
        if (!mounted) return;
        // 提前缓存DialogBuilder实例
        final dialogBuilder = DialogBuilder(context);
        dialogBuilder.showLoadingIndicator(
          heading: '请稍候...',
          text: '正在加载数据',
          color: Colors.black45,
        );

        try {
          String accountVerif = await uD.checkAccountId(
            emailController.text,
            passWordController.text,
          );
          print('账户验证结果：$accountVerif');

          if (!mounted) return;
          if (accountVerif == '') {
            await uD.downLoadUserInfo();
            final prefs = await SharedPreferences.getInstance();
            prefs.setString('email', emailController.text.toLowerCase());
            prefs.setString('passWord', passWordController.text);

            dialogBuilder.hideOpenDialog();
            Navigator.pushReplacementNamed(context, HomeScreen.id);
          } else {
            setState(() {
              emailController.clear();
              passWordController.clear();
            });
            Navigator.pop(context);
            // 启用错误弹窗时需添加挂载检查
            // if (mounted) {
            //   myAlertInfo(
            //     context,
            //     icone: Icons.warning,
            //     alerte: 'Oops... ',
            //     text: '该账户不存在，或密码错误。',
            //     bouton1: '确定',
            //     function1: () => Navigator.pop(context),
            //   );
            // }
          }
        } catch (e) {
          // 捕获异常并处理，避免崩溃
          if (mounted) {
            dialogBuilder.hideOpenDialog();
            showDialog(
              context: context,
              builder: (ctx) => AlertDialog(
                title: const Text('出错了'),
                content: const Text('操作失败，请重试'),
                actions: [
                  TextButton(
                    onPressed: () => Navigator.pop(context),
                    child: const Text('确定'),
                  ),
                ],
              ),
            );
          }
        }
      }
    },
    child: Text('登录', style: TextStyle(fontSize: uD.mediumFont)),
  ),
)

额外优化建议 #

• 可以给State类添加GlobalKey<NavigatorState>，直接通过key导航，彻底摆脱对BuildContext的依赖：

  final GlobalKey<NavigatorState> _navigatorKey = GlobalKey<NavigatorState>();
  
  // 导航时使用
  _navigatorKey.currentState?.pushReplacementNamed(HomeScreen.id);
  

• 异步操作中的SharedPreferences调用建议提前初始化，减少重复异步开销。

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