Flutter报错：type 'Null' is not a subtype of type 'String' 问题求助

问题分析与解决方案 #

针对你遇到的type 'Null' is not a subtype of type 'String'错误，结合代码细节，以下是可能的原因和对应解决方法：

1. snapshot.data未做非空断言 #

尽管snapshot.hasData为true，但Dart类型系统不会自动将AsyncSnapshot<User>.data从User?提升为User，直接访问user.firstName可能触发空值相关问题。

解决：
赋值时添加非空断言，明确告知编译器数据非空：

else if (snapshot.hasData) {
  final user = snapshot.data!; // 添加非空断言
  logger.i(user.firstName);
  return Text(getGreetingText(user.firstName));
}

2. getGreetingText函数返回null #

如果getGreetingText的返回类型为String?，且某些逻辑下返回了null，传入Text组件时会触发错误（Text的data参数要求非空字符串）。

解决：

• 确保getGreetingText始终返回非空字符串：

  String getGreetingText(String name) {
    return name.isNotEmpty ? 'Hello, $name!' : 'Hello Guest';
  }
  

• 或调用时添加空值兜底：

  Text(getGreetingText(user.firstName) ?? 'Hello Guest');
  

3. JSON序列化的隐藏空值问题 #

即使你打印user.firstName不为空，也可能存在JSON中given_name字段缺失/为null，但序列化代码未正确处理的情况。

解决：

• 重新运行序列化代码生成命令：

  flutter pub run build_runner build
  

• 为firstName字段添加默认值，避免JSON字段异常导致空值：

  @JsonKey(name: 'given_name', defaultValue: '')
  final String firstName;
  

4. FutureBuilder分支未返回Widget #

你当前的代码在snapshot.hasData分支中仅创建了Text但未return，会导致builder返回null，虽不是当前报错直接原因，但需修正：

FutureBuilder(
  future: _user,
  builder: (BuildContext context, AsyncSnapshot<User> snapshot) {
    if (snapshot.connectionState == ConnectionState.done) {
      if (snapshot.hasError) {
        return Center(
          child: Text(
            '${snapshot.error} occurred',
            style: const TextStyle(fontSize: 18),
          ),
        );
      } else if (snapshot.hasData) {
        final user = snapshot.data!;
        logger.i(user.firstName);
        return Text(getGreetingText(user.firstName)); // 添加return
      }
    }
    // 处理加载状态
    return const CircularProgressIndicator();
  },
)

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