Flutter检索Firestore文档存对象列表渲染卡片时出现null访问报错

• 全局变量初始化时序错误
  代码在类外部直接定义final userEvents = userEventsList;，这行逻辑在应用启动时就会执行，此时userEventsList还处于未初始化的null状态（getData方法还没被调用）；加上final修饰的变量赋值后不可修改，就算后续getData方法运行时给userEventsList赋值了有内容的列表，userEvents依然固定为初始化时的null值，后续遍历该对象时直接触发「在null上调用方法」的报错。
• 异步流处理逻辑错误
  你使用events.snapshots().forEach()监听Firestore数据流时，没有用await等待回调执行完成，代码会直接跳过流监听逻辑，执行后续的赋值操作；且Firestore的snapshots是长期推送的订阅流，本身不会主动关闭，forEach对应的回调永远不会同步触发，导致根本拿不到从Firestore拉取的文档数据。
• 列表存储结构偏差
  往列表写入数据时用了eventsList.add({firebaseEventDocs})的语法，实际是把单个Event对象包裹成了单元素Set存入列表，而非直接存储Event实例，后续从列表取到的是Set结构，读取对象属性时自然返回null。
• 类属性命名不匹配
  Event类中定义的属性是categoryID，但主页筛选逻辑中访问的是e.categoryIds，拼写、大小写完全不一致，该属性的访问结果为null，调用.contains()方法时必然抛出空指针异常。
• 未对Firestore字段做空值兼容
  直接通过文档快照的键值取字段时，如果某条文档缺失对应字段，取值会直接返回null，没有兜底逻辑的情况下，后续Widget渲染这些字段时也会触发空报错。

• 移除类外部提前初始化的userEvents全局final变量，直接用userEventsList参与UI渲染；确保只有当userEventsList完成数据赋值后，再触发UI刷新，避免引用空值。
• 修正Firestore数据拉取逻辑：如果只需要拉取一次数据，直接用await events.get()获取QuerySnapshot；如果需要实时监听数据变化，搭配StreamBuilder做响应式渲染，不要用无await的forEach逻辑处理订阅流。
• 往列表写数据时直接存入Event实例，移除冗余的Set包裹语法；把列表类型明确指定为List<Event>，避免dynamic类型的隐式类型转换问题。
• 统一类属性命名，把categoryID调整为和筛选逻辑匹配的categoryIds，避免因拼写不一致导致的空属性访问。
• 给Event类增加fromFirestore工厂构造方法，统一处理Firestore字段的空值兜底，给可能缺失的字段设置默认值，避免null值流入Widget渲染逻辑。

修复后的参考代码 #

数据拉取与Event类定义 #

import 'package:cloud_firestore/cloud_firestore.dart';

CollectionReference events = FirebaseFirestore.instance.collection("Events");
// 初始化空的Event列表，避免默认null
List<Event> userEventsList = [];

class Event {
  final String eventName, eventID, location, duration, description, creatorID, imagePath;
  String category;
  // 统一命名为categoryIds，和筛选逻辑对齐
  final List categoryIds;

  Event({
    this.imagePath = "assets/event_images/default_image.jpeg",
    this.eventName = "",
    this.eventID = "",
    this.location = "",
    this.duration = "",
    this.description = "",
    this.creatorID = "",
    this.categoryIds = const [0, 0],
  });

  // 统一处理Firestore数据映射，做空值兜底
  factory Event.fromFirestore(DocumentSnapshot doc) {
    final data = doc.data() as Map<String, dynamic>;
    return Event(
      eventID: doc.id,
      eventName: data["eventName"] ?? "",
      description: data["description"] ?? "",
      location: data["location"] ?? "",
      duration: data["duration"] ?? "",
      categoryIds: [0, data["category"] ?? 0],
    );
  }
}

Future<void> getData() async {
  // 拉取单次文档快照，等待数据返回
  final querySnapshot = await events.get();
  // 直接把文档映射为Event对象存入列表，不再包裹为Set
  userEventsList = querySnapshot.docs.map((doc) => Event.fromFirestore(doc)).toList();
}

UI渲染逻辑修正 #

Padding(
  padding: const EdgeInsets.symmetric(horizontal: 16.0),
  child: Consumer<AppState>(
    builder: (context, appState, _) => Column(
      children: <Widget>[
        // 遍历已初始化的Event列表，直接应用筛选逻辑
        for (final event in userEventsList.where((e) => e
            .categoryIds
            .contains(appState.selectedCategoryId)))
          GestureDetector(
            onTap: () {
              Navigator.of(context).push(
                MaterialPageRoute(
                  builder: (context) => EventDetailsPage(event: event),
                ),
              );
            },
            child: EventWidget(
              event: event,
            ),
          )
      ],
    ),
  ),
)

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