Flutter+Provider+FutureBuilder启动时触发空值检查运算符错误

错误现象 #

部分用户启动Flutter应用时触发「Null check operator used on a null value」错误，错误与获取Provider时使用的context直接相关，具体发生在以下代码行：

await _userDataController.loadSync(context, assinaturaController: _assinaturaController);

错误栈信息 #

#0 State.context (package:flutter/src/widgets/framework.dart:958)#1
_HomePageState.getData (package:appxxxx/pages/home_page.dart:211)<asynchronous suspend>#2
_FutureBuilderState._subscribe.<anonymous close> (package:flutter/src/widgets/async.dart:624)           <asynchronous suspend>

问题代码背景 #

错误代码位于FutureBuilder加载的getData异步方法中，完整方法代码如下：

Future<bool> getData() async {
try {
_abaController = context.read<AbaController>();
_assinaturaController = context.read<AssinaturaController>();
var _userDataController = context.read<UserDataController>();
isOnline = await Conexao.isOnline();

// 检查网络连接
if (isOnline == false)
   return Future<bool>.value(false);

// 从服务器获取当前时间
      await DataUtils.loadDateTimeServer();
// 初始化远程配置
await GetIt.I<RemoteConfigService>().loadData();
/// 检查是否需要强制更新
int versaoAppLocal = int.parse((await PackageInfo.fromPlatform()).buildNumber);
int versaoAppRemoteConfig = GetIt.I<RemoteConfigService>().versaoMinimaApp;
if (versaoAppLocal < versaoAppRemoteConfig){
  atualizacaoAppObrigatoria = true;
  return Future<bool>.value(false);
}

/// 检查环境是否维护中
if (GetIt.I<RemoteConfigService>().isAmbienteEmManutencao){
  isAmbienteEmManutencao = true;
  return Future<bool>.value(false);
}

// 初始化Firebase Auth并设置登录用户
await GetIt.I<AuthService>().init(context);
// 初始化订阅插件并判断用户订阅状态
await GetIt.I<PurchaseService>().load(context);
// 初始化通知插件设置
await _initializeNotificationsSetttings();
// 加载会话数据列表
await TickersHelper.load();
// 错误发生位置 ↓
await _userDataController.loadSync(context, assinaturaController: _assinaturaController);
_requestPermissions();
_configureDidReceiveLocalNotificationSubject();
_configureSelectNotificationSubject();
_loadAndSetTabIcons();
await GetIt.I<UsuarioApiService>().callIncluirTokenPush();
await GetIt.I<NotificacoesHelper>().programaNotifications(context);


await _showDialogUmpCMP();
await _autenticaBiometria();
await _initDynamicLinks();

} catch (ex, stack) {
   ....
}

排查思路与解决方案 #

核心原因 #

错误栈指向State.context，说明调用loadSync时context已变为null。getData作为FutureBuilder的异步回调，若HomePageState在异步操作完成前被销毁（比如用户快速退出页面、页面意外dispose），此时context会失效，调用相关方法就会触发空检查错误。

具体解决方案 #

1. 添加mounted状态检查
   在使用context前先判断当前State是否还挂载在组件树中，避免在销毁后执行逻辑：

   // 在错误代码行前添加检查
   if (!mounted) return false;
   await _userDataController.loadSync(context, assinaturaController: _assinaturaController);
   

   建议在所有依赖context的异步操作前都加入该检查。

2. 重构初始化逻辑的执行时机
   将大量初始化逻辑从FutureBuilder回调移到initState中（注意initState不能直接用async，需用Future.microtask包裹），或使用WidgetsBinding.instance.addPostFrameCallback延迟执行：

   @override
   void initState() {
     super.initState();
     Future.microtask(() => _initAppLogic());
   }
   
   Future<void> _initAppLogic() async {
     if (!mounted) return;
     // 执行原getData中的初始化逻辑
   }
   

3. 减少对UI context的依赖
   若_userDataController是通过GetIt注入的，直接从GetIt获取实例，避免传递context：

   // 替换context.read<UserDataController>()
   var _userDataController = GetIt.I<UserDataController>();
   // 修改loadSync方法，移除context参数，内部依赖改用GetIt获取
   await _userDataController.loadSync(assinaturaController: _assinaturaController);
   

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