Flutter BlocBuilder返回null报错：返回类型Widget为非可空类型

问题原因 #

报错源于Dart的非空安全机制：BlocBuilder的builder函数要求必须返回非可空的Widget类型，但当前代码仅处理了4种AuthenticationState分支，当出现未覆盖的状态时，函数会隐式返回null，触发非空类型校验错误。

修复方案 #

只需添加默认返回分支，确保无论什么状态都有Widget返回，以下是两种常用修复方式：

方式1：添加兜底返回Widget

在所有if判断后补充兜底逻辑，比如返回空容器或自定义错误页面：

home: BlocBuilder<AuthenticationBloc, AuthenticationState>(
        builder: (context, state) {
          if (state is AuthenticationUnintialized) {
            return SplashPage();
          }
          if (state is AuthenticationAuthenticated) {
            return MapSample();
          }
          if (state is AuthenticationUnauthenticated) {
            return LoginPage(userRepository: userRepository);
          }
          if (state is AuthenticationLoading) {
            return LoadingIndicator();
          }
          // 兜底返回，避免返回null
          return SizedBox.shrink(); // 可替换为自定义错误页面
        },
      ),

方式2：使用switch-case（更严谨）

用Dart模式匹配的switch-case处理状态，配合断言确保覆盖所有分支，后续新增状态时编译器会自动提示补充：

home: BlocBuilder<AuthenticationBloc, AuthenticationState>(
        builder: (context, state) {
          return switch(state) {
            AuthenticationUnintialized() => SplashPage(),
            AuthenticationAuthenticated() => MapSample(),
            AuthenticationUnauthenticated() => LoginPage(userRepository: userRepository),
            AuthenticationLoading() => LoadingIndicator(),
            _ => throw UnimplementedError('未处理的状态: $state'),
          };
        },
      ),

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