Flutter Navigator 锁定错误

导航跳转时提示报错

Assertion failed: >file:///D:/sdk/flutter/packages/flutter/lib/src/widgets/navigator.dart:4536:12 !_debugLocked is not true

报错原因:

Navigator 内部在处理一次导航(比如 pushpop)时,会将其锁定(_debugLocked = true),直到该导航操作完成。

你看到这个错误说明:

在正在执行 pushpoppushReplacement 等操作期间,又触发了新的导航请求。

例如,可能触发这个报错情形

build() 过程中触发导航

scss 复制代码
dart
@override
Widget build(BuildContext context) {
  Navigator.pushNamed(context, '/home'); // ❌ 错误:build 过程中导航
  return Container();
}
perl 复制代码
dart
onPressed: () {
  Navigator.pop(context); // 弹窗关闭
  Navigator.pushNamed(context, '/next'); // ❌ 同步立即 push,会报错
}

解决方法

使用 Future.microtask / WidgetsBinding.instance.addPostFrameCallback

推迟导航操作,等当前帧绘制完毕:

ini 复制代码
dart
WidgetsBinding.instance.addPostFrameCallback((_) {
  Navigator.pushNamed(context, '/home');
});

或者:

ini 复制代码
dart
Future.microtask(() {
  Navigator.pushNamed(context, '/home');
});

await 弹窗关闭之后再导航

dart 复制代码
dart
onPressed: () async {
  Navigator.pop(context); // 关闭弹窗
  await Future.delayed(Duration(milliseconds: 300)); // 等一会儿再导航
  Navigator.pushNamed(context, '/next');
}
相关推荐
叽哥1 小时前
dart学习第1节: 变量与数据类型 —— 程序的 “基本元素”
flutter
喝拿铁写前端15 小时前
Flutter 学习笔记 - 搭建(macOS 版)
前端·flutter
ALLIN15 小时前
Mac Flutter fvm 多版本管理安装与常用指令(详细使用)
flutter
梦想改变生活20 小时前
《Flutter篇第二章》MasonryGridView瀑布流列表
android·flutter
SoaringHeart2 天前
Flutter小技巧:IM音浪效果实现
前端·flutter
Bryce李小白2 天前
Flutter中实现页面跳转功能
flutter
RaidenLiu3 天前
Flutter 多环境配置:flavor
前端·flutter
忆江南3 天前
Widget 、 Element 和 RenderObject 关系
flutter
程序员老刘3 天前
“工信部要求9月30日前APP必须100%适配鸿蒙“ 是真的吗?
flutter·harmonyos
亿刀3 天前
WireGuard通讯原理
android·flutter