Flutter Firebase QuerySnapshot转换报错：运算符'[]'未定义于Object类

问题原因 #

在Firebase Firestore的最新版本中，QueryDocumentSnapshot.data()方法返回的类型是Object?，而非早期版本的Map<String, dynamic>，直接使用[]下标运算符会触发类型不匹配错误。

解决方案 #

需要将doc.data()显式转换为Map<String, dynamic>?类型后再访问字段，以下是两种可行的修改方式：

方式1：提取数据变量再处理 #

List<PostModel> _postListFromSnapshot(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    final docData = doc.data() as Map<String, dynamic>?;
    return PostModel(
      id: doc.id,
      text: docData?['text'] ?? '',
      creator: docData?['creator'] ?? '',
      timestamp: docData?['timestamp'] ?? 0,
    );
  }).toList();
}

方式2：直接在字段访问时转换 #

List<PostModel> _postListFromSnapshot(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    return PostModel(
      id: doc.id,
      text: (doc.data() as Map<String, dynamic>?)?['text'] ?? '',
      creator: (doc.data() as Map<String, dynamic>?)?['creator'] ?? '',
      timestamp: (doc.data() as Map<String, dynamic>?)?['timestamp'] ?? 0,
    );
  }).toList();
}

进阶优化（推荐） #

使用Firestore的withConverter方法提前绑定类型，从根源避免类型转换问题：

// 先为PostModel定义转换器
final postsCollection = FirebaseFirestore.instance
    .collection('posts')
    .withConverter<PostModel>(
      fromFirestore: (snapshot, _) => PostModel.fromJson(snapshot.data()!),
      toFirestore: (post, _) => post.toJson(),
    );

// 获取数据时直接得到PostModel列表
Future<List<PostModel>> fetchPosts() async {
  final snapshot = await postsCollection.get();
  return snapshot.docs.map((doc) => doc.data()).toList();
}

这种方式更符合Flutter类型安全的最佳实践，同时简化后续数据处理逻辑。

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