使用showcaseview:^1.1.1时出现Null check operator空指针异常如何解决

架构老林

2026-10-6

报错原因

本次空指针触发在showcaseview: ^1.1.1的内部Overlay构建逻辑中，核心原因是调用startShowCase方法时，要么是ShowCaseWidget.of(context)获取到的实例为空，要么是你传入的全局Key_one对应的Showcase组件还未完成挂载，组件位置信息为空，触发了框架内部的强制非空断言报错。
你当前将ShowCaseWidget直接套在MaterialApp.router外层，路由上下文和ShowCaseWidget的上下文存在层级差，也会导致页面初始化时获取ShowCaseWidget实例异常。

修复方案

移除所有强制非空断言，先判断实例和组件是否挂载完成再调用启动方法：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // 先校验ShowCaseWidget实例和目标组件是否都已挂载
    final showcaseInstance = ShowCaseWidget.of(context);
    if (mounted && showcaseInstance != null && _one.currentContext != null) {
      showcaseInstance.startShowCase([_one]);
    }
  });
}

若上述方案仍有报错，可将启动逻辑再延迟一帧执行，保证Widget树完全渲染：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.endOfFrame.then((_) async {
    await Future.delayed(Duration.zero);
    if (mounted) {
      final showcaseInstance = ShowCaseWidget.of(context);
      if (showcaseInstance != null && _one.currentContext != null) {
        showcaseInstance.startShowCase([_one]);
      }
    }
  });
}