Flutter登录报错：类型'Null'不是类型转换中'_StateDataWidget'的子类型

问题分析 #

报错Sign In Error: type 'Null' is not a subtype of type '_StateDataWidget' in type cast的触发位置为StateWidget的of静态方法：调用context.dependOnInheritedWidgetOfExactType<_StateDataWidget>()时，当前上下文的上层组件树中找不到_StateDataWidget实例，返回了Null，后续直接用as _StateDataWidget强制类型转换触发崩溃。

解决方案 #

按以下顺序排查修复即可：

• 1. 修正根组件嵌套结构
     确保你的应用根节点是StateWidget包裹了MaterialApp/CupertinoApp，保证所有路由页面的上下文都能找到上层的_StateDataWidget，示例代码：

void main() {
  runApp(
    StateWidget(
      // 传入初始化的StateModel实例
      state: StateModel(isLoading: true, firebaseUserAuth: null, user: null, userSettings: null),
      child: const MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // 你的路由、主题等配置
      home: const LoginForm(),
    );
  }
}

如果StateWidget仅包裹了某个子路由，登录页不在它的子组件树范围内，就会触发该报错。

• 2. 优化StateWidget.of方法的空安全校验
     移除强制类型转换，增加空判断抛出明确的错误信息，降低后续排查成本：

static _StateWidgetState of(BuildContext context) {
  final _StateDataWidget? inheritedWidget = context.dependOnInheritedWidgetOfExactType<_StateDataWidget>();
  if (inheritedWidget == null) {
    throw Exception('请确保StateWidget已包裹当前页面的父组件树');
  }
  return inheritedWidget.data;
}

• 3. 修复_StateWidgetState初始化逻辑的错误
     原initState方法中widget.state != null的判断无意义（StateWidget构造函数已将state标记为required非空），且else分支在state未完成初始化时就调用this.state属性会触发LateInitializationError，修正后代码：

@override
void initState() {
  super.initState();
  state = widget.state;
  // 仅当未初始化用户数据时调用initUser
  if (state.firebaseUserAuth == null) {
    initUser();
  }
}

• 4. 移除不必要的强制非空转换
     initUser、logOutUser方法中的as User、!强制非空转换在返回数据为空时会触发崩溃，建议增加空判断逻辑，未登录场景下对应赋值为null即可，不要强制要求非空。

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