Flutter升级后FutureBuilder报Object?非Widget类型错误如何解决

规则调整原因 #

本次报错是Dart 2.12+ 空安全机制落地后，Flutter对FutureBuilder的类型校验规则收紧导致的，具体有两个核心触发点：

• 未指定泛型的FutureBuilder默认会将snapshot.data推断为Object?类型，而builder闭包强制要求返回值必须是Widget类型，类型不匹配直接触发报错。
• 原有test异步函数未声明返回值，默认返回Future<void>，你获取到的下载链接根本不会传递给FutureBuilder，除了类型不匹配的问题之外，你也拿不到想要的数据。

修复方案 #

按以下步骤调整即可正常获取异步数据并渲染：

1. 给test函数添加明确的返回值类型，将下载链接作为返回值传递，修改后的test函数为：

Future<String?> test() async {
  await Firebase.initializeApp();
  String downloadURL = await firebase_storage.FirebaseStorage.instance
      .ref('achtergrond.jpg')
      .getDownloadURL();
  print(downloadURL);
  return downloadURL;
}

2. 给FutureBuilder指定对应泛型，同时在builder中处理加载、错误、成功三种状态，每种状态返回对应Widget：

FutureBuilder<String?>(
  future: test(),
  builder: (BuildContext context, AsyncSnapshot<String?> snapshot) {
    // 加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }
    // 错误状态
    if (snapshot.hasError) {
      return Text('加载失败：${snapshot.error}');
    }
    // 成功获取数据
    if (snapshot.hasData) {
      // 示例：将获取到的链接渲染为网络图片
      return Image.network(snapshot.data!);
    }
    // 无数据兜底
    return const Text('暂无图片资源');
  },
)

调整后snapshot.data的类型会被明确推断为String?，且所有分支都返回符合要求的Widget，即可正常运行。

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