迁移至空安全后Firestore数据存入Model报错，强转dynamic是最优解法吗？

首先明确：你用(doc.data() as dynamic)['id']的临时方案不是最优解，强转dynamic会完全丢失Dart的类型校验能力，字段名写错、类型不匹配的问题只会在运行期暴露，排查成本极高。

报错原因 #

新版cloud_firestore适配空安全后，DocumentSnapshot的data()方法返回值类型为Map<String, dynamic>?，本身是可空的，不能直接调用[]运算符。

最优处理方案 #

分两步优化，兼顾类型安全和易用性：

1. 修正fromDocument工厂方法 #

先对data()做类型转换，结合空安全运算符取值：

import 'package:cloud_firestore/cloud_firestore.dart';

class UserModel
{
  final String? id;
  final String? username;
  final String? email;
  final String? url;
  final String? androidNotificationToken;

  UserModel({
    this.id,
    this.username,
    this.email,
    this.url,
    this.androidNotificationToken,
  });

  factory UserModel.fromDocument(DocumentSnapshot doc)
  {
    // 先做确定类型的可空转换
    final Map<String, dynamic>? data = doc.data() as Map<String, dynamic>?;
    return UserModel(
      id: data?['id'] as String?,
      username: data?['username'] as String?,
      email: data?['email'] as String?,
      url: data?['url'] as String?,
      androidNotificationToken: data?['androidNotificationToken'] as String?,
    );
  }

  // 补充toJson方法，方便后续写入Firestore
  Map<String, dynamic> toJson() => {
    'id': id,
    'username': username,
    'email': email,
    'url': url,
    'androidNotificationToken': androidNotificationToken,
  };
}

2. 搭配Firestore的withConverter实现全局类型自动转换 #

操作集合/文档时提前绑定转换器，后续读写数据全程自动完成类型转换，无需手动调用工厂方法：

// 定义用户集合引用时直接绑定转换器
final userCollection = FirebaseFirestore.instance
    .collection('users')
    .withConverter<UserModel>(
      fromFirestore: (snapshot, _) => UserModel.fromDocument(snapshot),
      toFirestore: (user, _) => user.toJson(),
    );

// 后续读取示例：直接拿到UserModel类型对象，无需手动解析
Future<UserModel?> getUser(String uid) async {
  final doc = await userCollection.doc(uid).get();
  return doc.data();
}

// 后续写入示例：直接传入UserModel对象，无需手动转Map
Future<void> saveUser(UserModel user) async {
  await userCollection.doc(user.id).set(user);
}

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