如何从Firebase集合中获取所有文档并添加至Event列表？

我在Firebase中有一个events集合，想要获取其中的所有文档并添加到列表中：

我已经定义了一个Event模型类，希望在将事件添加到列表之前，用从Firebase读取的数据创建Event对象。

Event模型类代码 #

class Event {
  String eid;
  String title;
  String location;
  String start;
  String end;
  String instructor;
  String image;
  String description;

  Event({
    required this.eid,
    required this.title,
    required this.location,
    required this.start,
    required this.end,
    required this.instructor,
    required this.image,
    required this.description
  });

  String getEid() {
    return eid;
  }

  String getTitle() {
    return title;
  }

  String getLocation() {
    return location;
  }

  String getStart() {
    return start;
  }

  String getEnd() {
    return end;
  }

  String getInstructor() {
    return instructor;
  }

  String getImage() {
    return image;
  }

  String getDescription() {
    return description;
  }

  void setEid(String eid) {
    this.eid = eid;
  }

  void setTitle(String title) {
    this.title = title;
  }

  void setLocation(String location) {
    this.location = location;
  }

  void setStart(String start) {
    this.start = start;
  }

  void setEnd(String end) {
    this.end = end;
  }

  void setInstructor(String instructor) {
    this.instructor = instructor;
  }

  void setImage(String image) {
    this.image = image;
  }

  void setDescription(String description) {
    this.description = description;
  }
}

我当前的代码（存在问题） #

我尝试创建Event对象列表，获取整个集合，为每个文档创建Event对象并添加到列表，但不确定是否正确：

List<Event> _events = [];

Future<UserProfile> getUserProfile() async {
  try {
    final FirebaseAuth auth = FirebaseAuth.instance;

    final snapshot = await FirebaseFirestore.instance.collection('events').get();
    snapshot.docs.forEach((doc) {
      Map<String, dynamic>? data = snapshot.data();
      Event event = Event(
            eid: data?['eid'],
            title: data?['title'],
            ...
    });

修正后的实现方案 #

你的代码存在几个明显问题：

1. 错误调用snapshot.data()，应该用当前遍历的doc.data()获取单条文档数据
2. 方法返回类型Future<UserProfile>与实际逻辑（获取事件列表）不匹配
3. 未将创建好的Event对象添加到_events列表中
4. 缺少异常处理分支和完整的方法逻辑

以下是修正后的完整代码：

List<Event> _events = [];

// 根据需求调整返回类型，这里以获取事件列表为例
Future<void> fetchEvents() async {
  try {
    final snapshot = await FirebaseFirestore.instance.collection('events').get();
    
    // 清空列表避免重复数据
    _events.clear();
    
    for (var doc in snapshot.docs) {
      // 获取当前文档的键值对数据
      Map<String, dynamic> data = doc.data();
      
      // 创建Event对象，添加空值兜底避免null错误
      Event event = Event(
        eid: data['eid'] ?? '',
        title: data['title'] ?? '',
        location: data['location'] ?? '',
        start: data['start'] ?? '',
        end: data['end'] ?? '',
        instructor: data['instructor'] ?? '',
        image: data['image'] ?? '',
        description: data['description'] ?? '',
      );
      
      // 将对象加入列表
      _events.add(event);
    }
    
    print('成功获取${_events.length}条事件数据');
  } catch (e) {
    print('获取事件列表失败: $e');
    // 这里可添加UI层面的错误提示逻辑
  }
}

额外优化建议 #

1. 在Event类中添加工厂构造函数，简化对象创建：

factory Event.fromMap(Map<String, dynamic> map) {
  return Event(
    eid: map['eid'] ?? '',
    title: map['title'] ?? '',
    location: map['location'] ?? '',
    start: map['start'] ?? '',
    end: map['end'] ?? '',
    instructor: map['instructor'] ?? '',
    image: map['image'] ?? '',
    description: map['description'] ?? '',
  );
}

之后创建对象可简化为：

Event event = Event.fromMap(doc.data());

2. 若需要实时监听集合数据变化，可使用流替代单次获取：

Stream<List<Event>> getEventsStream() {
  return FirebaseFirestore.instance.collection('events').snapshots().map((snapshot) {
    return snapshot.docs.map((doc) => Event.fromMap(doc.data())).toList();
  });
}

在UI层通过StreamBuilder监听该流，即可实现数据实时更新。

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