Flutter中GestureDetector点击跳转报错'!_debugLocked'求助

问题本质 #

这个错误是因为Navigator在执行导航操作的临界阶段（比如组件正在构建、已有导航栈变更处理中）被触发了新的导航请求，触发了内部锁机制的断言。

具体修复方案 #

1. 延迟到组件构建完成后执行导航 #

把导航代码放到组件构建完成的回调里，避开构建阶段的锁限制：

GestureDetector(
  onTap: () {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      Navigator.push(
        context,
        MaterialPageRoute(builder: (context) => DetailsScreen()),
      );
    });
  },
  child: RecomendedPlantCard(...),
)

2. 用微任务队列延迟执行 #

通过微任务确保当前帧所有操作完成后再触发导航：

onTap: () {
  Future.microtask(() {
    Navigator.push(context, MaterialPageRoute(builder: (_) => DetailsScreen()));
  });
},

3. 排查重复点击触发 #

检查RecomendedPlantCard内部是否还有其他可点击组件（比如InkWell、嵌套GestureDetector），导致一次点击触发多次导航。可以给外层GestureDetector添加行为拦截：

GestureDetector(
  behavior: HitTestBehavior.opaque,
  onTap: () {
    Navigator.push(context, MaterialPageRoute(builder: (_) => DetailsScreen()));
  },
  child: RecomendedPlantCard(...),
)

4. 确认context有效性 #

确保使用的context是包含在Navigator导航栈范围内的，不要用全局context或者已脱离导航栈的context。StatelessWidget直接用build方法的context即可，StatefulWidget要保证state的context未被销毁。

额外排查点 #

• 别在initState、didChangeDependencies这类生命周期方法里直接触发导航，这些阶段组件还没完成构建，也会触发锁错误。
• 如果用状态管理工具（比如Provider、Bloc）触发导航，要确保状态变更的回调不是在组件构建期间执行的。

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