Flutter调用Navigator.pop触发!_debugLocked断言失败的解决方法

这个错误本质是Navigator状态处于锁定状态时（比如push/pop操作还未完成），又发起了新的导航操作，或者在生命周期方法里直接调用导航方法导致的。以下是具体解决办法：

1. 绝对不要在build方法里直接调用导航操作 #

build方法会频繁执行，若在此处触发push/pop，极大概率和导航锁冲突。如果必须在页面初始化时跳转，用WidgetsBinding.instance.addPostFrameCallback延迟到当前帧渲染完成后执行：

@override
void initState() {
  super.initState();
  // 延迟到当前帧构建完成后再执行导航
  WidgetsBinding.instance.addPostFrameCallback((_) {
    Navigator.push(context, MaterialPageRoute(builder: (_) => DetailsScreen()));
  });
}

2. 确保pop操作在导航锁释放后执行 #

如果是异步操作（比如网络请求）完成后触发pop，或者在回调里执行pop，用Future.microtask包裹，确保导航状态已解锁：

// 比如异步请求完成后返回
Future<void> handleDataFetch() async {
  await fetchSomeData();
  // 用microtask规避导航锁
  Future.microtask(() => Navigator.pop(context));
}

3. 检查Navigator的context是否正确 #

如果使用了全局NavigatorKey管理导航，调用pop时优先用key的currentState，避免context对应的Navigator状态不一致：

// 定义全局key
final GlobalKey<NavigatorState> navigatorKey = GlobalKey();

// 在MaterialApp中配置
MaterialApp(
  navigatorKey: navigatorKey,
  home: HomeBody(),
);

// 调用pop时
navigatorKey.currentState?.pop();

4. 移除导航操作外的setState包裹 #

你之前把Navigator.push放进setState里是错误操作——导航本身会触发UI更新，不需要额外用setState包裹，直接移除即可，否则会导致状态更新和导航操作冲突。

内容的提问来源于stack exchange，提问作者Hãmžã Hãwąťö