Flutter异步等待Navigator.push触发use_build_context_synchronously警告如何解决

结论：不要直接忽略该警告 #

异步等待期间如果当前BuildContext对应的Widget已经被销毁（例如用户手动关闭了底部弹窗、父路由被主动弹出），失效的BuildContext调用导航方法会触发运行时异常，极端场景会导致应用崩溃。

无需StatefulWidget、无需检查mounted的规范解决方案 #

最通用的实现方式是在异步操作执行前，提前通过context获取Navigator实例的引用，后续操作直接使用该引用即可，不需要再次访问context：

场景1：push页面后自动pop当前页面 #

修改后代码：

onTap: () async {
  // 异步等待前提前获取Navigator实例
  final navigator = Navigator.of(context);
  await navigator.pushNamed(
    RoomAddPage.routeName,
    arguments: room,
  );
  // 直接使用预取的navigator执行操作，不再访问context
  navigator.pop();
},

场景2：底部弹窗确认后关闭自身 #

修改后代码：

onTap: () async {
  final navigator = Navigator.of(context);
  bool? deleteConfirmed = await showModalBottomSheet<bool>(/* 打开确认弹窗 */);
  if (deleteConfirmed == true) {
    navigator.pop();
  }
},

方案原理 #

该实现完全符合Dart linter的规则要求：所有对BuildContext的访问都发生在异步gap之前，异步操作结束后没有再访问context，因此不会触发use_build_context_synchronously警告。
只要预取的Navigator实例对应的路由栈没有被完全销毁（正常业务场景下根路由的Navigator实例整个应用生命周期内都有效），调用pop等操作就完全安全，也不需要额外判断mounted状态。

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