Flutter从Firestore获取Feed时遭遇类型转换错误求助

错误信息 #

E/flutter (20020): [ERROR:flutter/lib/ui/ui_dart_state.cc(198)] Unhandled Exception: type 'Null' is not a subtype of type 'Iterable'
E/flutter (20020): #0 _MomentsFeedState.getWidgetList (package:buzz/moments/moment_feed.dart:78:40)
E/flutter (20020):

相关代码 #

数据获取函数 #

Stream<List<String>> getFriendUUIDS() => Firestore.friends
    .doc(gameManager.myself.uuid)
    .snapshots()
    .map((snapshot) => ((snapshot.data()?.keys)?.toList()) ?? []);

Future<List<MomentWidget>> getWidgetList() async{
  List<MomentWidget> widgetList = [];
  Set<String> momentIds = Set();
  await for (final uuids in getFriendUUIDS()){
    for (String uuid in uuids){
      DocumentSnapshot<Map<String, dynamic>> values =  await Firestore.users
      .doc(uuid)
      .get();
      for (String momentId in values.data()?['moments']){
        debugPrint('momentId: $momentId');
        momentIds.add(momentId);
      }
    }
  }
  
  for (String momentId in momentIds){
    DocumentSnapshot<Map<String, dynamic>> values = 
    await Firestore.instance.collection('moments').doc(momentId).get();
    Map<String, dynamic>? data = values.data()!;
    String downloadURL = await storage.ref('moments/$momentId').getDownloadURL();
    MomentWidget widget = MomentWidget(numLikes: data['liked_by'].length ,
     location: data['location'],
      date: data['timestamp'],
      names: data['taggedFriends'].toString(),
      shotBy: data['taken_by'], image: NetworkImage(downloadURL));
    widgetList.add(widget);
  }
  return widgetList;
}

Feed构建函数 #

Widget feed(){
  Size size = MediaQuery.of(context).size;
  return Container(
    height: size.height,
    width: size.width,
    child: FutureBuilder(
      future: getWidgetList(),
      builder: (context, AsyncSnapshot<List<MomentWidget>> snapshot) {
        switch (snapshot.connectionState) {
          case ConnectionState.waiting:
            return Center(
              child: CircularProgressIndicator(),
            );
          case ConnectionState.done:
            if (snapshot.hasError) {
              return Text(snapshot.error.toString());
            } else {
              return ListView.builder(
                  shrinkWrap: true,
                  scrollDirection: Axis.vertical,
                  itemBuilder: (context, pos) {
                    return snapshot.data![pos];
                  },
                );
            }
          default:
            return Text('Unhandled State');
        }
      }
    ),
    );
}

@override
Widget build(BuildContext context) {
  getWidgetList();
  return Scaffold(
    body: Container(
      width: MediaQuery.of(context).size.width,
      child: feed(),
    ),
  );
}

问题分析与解决 #

核心错误原因 #

错误指向getWidgetList方法中遍历values.data()?['moments']的代码——当该字段为null时，for...in无法遍历空值，直接抛出类型转换错误。此外还有几处潜在的空值风险和异步逻辑问题。

修复步骤 #

1. 处理moments字段的空值
   遍历前先判断字段是否为空，用空列表替代null：

   // 替换原for循环
   final moments = values.data()?['moments'] ?? [];
   for (String momentId in moments){
     debugPrint('momentId: $momentId');
     momentIds.add(momentId);
   }
   

2. 修复MomentWidget构建时的空值
   对liked_by、taggedFriends等可能为空的字段添加默认值：

   MomentWidget widget = MomentWidget(
     numLikes: (data['liked_by'] as List?)?.length ?? 0,
     location: data['location'] ?? '未知位置',
     date: data['timestamp'] ?? DateTime.now(),
     names: (data['taggedFriends'] as List?)?.join(', ') ?? '无',
     shotBy: data['taken_by'] ?? '匿名',
     image: NetworkImage(downloadURL)
   );
   

3. 优化FutureBuilder的使用
   避免在build方法中重复发起请求，将Future存入State变量：

   late final Future<List<MomentWidget>> _widgetListFuture;
   
   @override
   void initState() {
     super.initState();
     _widgetListFuture = getWidgetList();
   }
   
   // 在feed()的FutureBuilder中使用_widgetListFuture
   FutureBuilder(
     future: _widgetListFuture,
     // ... 原有构建逻辑
   )
   

4. 修正Stream转Future的逻辑
   getFriendUUIDS()返回的是Stream，用await for会持续监听流，导致Future永远无法完成。如果只需要单次获取好友UUID，改为返回Future：

   Future<List<String>> getFriendUUIDS() async {
     final snapshot = await Firestore.friends.doc(gameManager.myself.uuid).get();
     return (snapshot.data()?.keys)?.toList() ?? [];
   }
   
   // 在getWidgetList中直接调用
   final uuids = await getFriendUUIDS();
   for (String uuid in uuids){
     // ... 原有逻辑
   }
   

   若需要实时监听好友列表更新，应改用StreamBuilder而非FutureBuilder。

最终效果 #

修复后，空值会被正确处理，FutureBuilder能正常获取Widget列表并渲染ListView，同时避免重复请求和异步逻辑异常。

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