Flutter空安全迁移问题：类型'Object'未定义运算符'[]'如何解决

报错根因 #

cloud_firestore 2.0及以上版本适配空安全后，DocumentSnapshot的data()方法返回值类型从原来的Map<String, dynamic>调整为Object?，Dart编译器无法直接判定返回值为Map结构，因此不支持直接用[]运算符访问字段。 #

可选用的解决方法 #

• 方法1：显式强转类型（最常用）
  将data()返回值显式转换为Map<String, dynamic>即可正常访问字段，代码修改如下：

import 'package:cloud_firestore/cloud_firestore.dart';

class UserModel {
  static const NUMBER = 'number';
  static const ID = 'id';

  late String _number;
  late String _id;

  // getter
  String get number => _number;
  String get id => _id;

  UserModel.fromSnapshot(DocumentSnapshot snapshot) {
    // 新增这行做类型转换
    final data = snapshot.data() as Map<String, dynamic>;
    _number = data[NUMBER];
    _id = data[ID];
  }
}

适用于你确定Firestore返回的结构一定是Map的场景，代码简洁效率高。 #

• 方法2：安全类型判断（容错性最高）
  增加类型判断逻辑，避免强转失败导致崩溃，适合线上生产环境使用：

UserModel.fromSnapshot(DocumentSnapshot snapshot) {
  final data = snapshot.data();
  if (data is Map<String, dynamic>) {
    _number = data[NUMBER];
    _id = data[ID];
  } else {
    // 数据格式异常时赋值默认值，也可抛出自定义异常
    _number = '';
    _id = '';
  }
}

• 方法3：提前指定文档类型（全局避免强转）
  在定义DocumentReference时使用withConverter提前指定数据类型，后续所有拿到的snapshot.data()都会是指定的Map类型，不需要每次转换：

// 定义文档引用时提前声明类型
final userRef = FirebaseFirestore.instance
    .collection('users')
    .doc('你的用户ID')
    .withConverter<Map<String, dynamic>>(
      fromFirestore: (snapshot, options) => snapshot.data()!,
      toFirestore: (map, options) => map,
    );

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