Flutter页面导航突然失效，请求排查原因

问题还原 #

之前正常工作的Flutter页面路由突然失效，调用pinPage方法后控制台打印了"ran"，但页面没有完成跳转，相关代码如下：

void pinPage(LatLng point) {
    Navigator.push(
    context,
    MaterialPageRoute(
        builder: (context) => pin_attributes(
              key: const ValueKey(1),
              local: point,
              userId: userId,
            )));
print("ran");
}

排查与解决方向 #

• 校验Context有效性：确保调用pinPage时的context属于当前活跃的Widget树，比如异步回调里调用的话，Context可能已过期。可以改用GlobalKey获取Navigator对应的Context，或者在StatefulWidget的state.context中执行路由操作。
• 排查目标页面异常：pin_attributes页面的初始化或build方法如果抛出异常，会导致路由跳转失败但控制台无明显报错。先临时把目标页面换成简单的测试页（比如Scaffold(body: Text("Test"))），验证是页面本身问题还是路由调用问题。
• 强制使用根Navigator：如果当前Context对应的Navigator不是根Navigator，可能导致跳转失效。尝试用Navigator.of(context, rootNavigator: true).push(...)代替原调用。
• 确保在UI线程执行：如果pinPage是在异步操作（比如网络请求）后触发，用WidgetsBinding.instance.addPostFrameCallback((_) { ... })包裹Navigator调用，保证在UI帧更新时执行。
• 移除固定路由Key：代码中给pin_attributes设置了固定的ValueKey(1)，若栈中已有相同Key的页面，会干扰路由入栈。可以去掉固定Key，或者基于point坐标生成动态唯一Key。

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