如何使用Map参数从Firebase获取数据并修正模型解析问题

我使用Firebase进行数据调用已有一段时间，但在处理Map类型参数时遇到问题。以下是我的Game模型代码：

import 'package:cloud_firestore/cloud_firestore.dart';

class Game {
  final Map<String, String> name;
  final String id;

  Game({
    required this.name,
    required this.id,
  });

  Map<String, dynamic> toMap() {
    return {
      'Name': name,
      'id': id,
    };
  }

  factory Game.fromDocument(DocumentSnapshot documentSnapshot) {
    return Game(
      name: documentSnapshot['Name'],
      id: documentSnapshot['id'],
    );
  }
}

其中fromDocument工厂函数处理Map类型字段的方式不正确，请问如何修正该函数，使我能正常使用以下GamesStateNotifier Provider并在页面中调用？

GamesStateNotifier代码：

class GamesStateNotifier extends StateNotifier<List<Game>> {
  final FirebaseFirestore firebaseFirestore;
  final String pathGame;

  StreamSubscription? _streamSubscription;

  GamesStateNotifier({
    required this.firebaseFirestore,
    required this.pathGame,
  }) : super([]);

  Future<void> init() async {
    _streamSubscription =
        firebaseFirestore.collection(pathGame).snapshots().listen((event) {
      state = event.docs.map((e) => Game.fromDocument(e)).toList();
    });
  }

  @override
  void dispose() {
    if (_streamSubscription != null) {
      _streamSubscription!.cancel();
    }
    super.dispose();
  }
}

final gamesStateNotfierProvider =
    StateNotifierProvider<GamesStateNotifier, List<Game>>((ref) {
  final firestore = ref.watch(InstanteGames);
  final path1 = ref.watch(PathGames);

  return GamesStateNotifier(
    firebaseFirestore: firestore,
    pathGame: path1,
  )..init();
});

页面调用代码：

final gamesWatch = ref.watch(gamesStateNotfierProvider);

问题核心是Firestore返回的documentSnapshot['Name']为dynamic类型，直接赋值给Map<String, String>会触发类型转换错误，需显式处理类型转换+空值防护，修正后的fromDocument函数如下：

factory Game.fromDocument(DocumentSnapshot documentSnapshot) {
  // 先获取完整文档数据，转为可空的Map类型
  final data = documentSnapshot.data() as Map<String, dynamic>?;
  
  return Game(
    // 将dynamic类型的Map转换为Map<String, String>，同时处理空值
    name: (data?['Name'] as Map<String, dynamic>?)?.map(
          (key, value) => MapEntry(key, value?.toString() ?? ''),
        ) ?? {},
    // 处理id字段的空值情况，避免Null错误
    id: data?['id'] as String? ?? '',
  );
}

关键说明 #

1. 类型适配：Firestore存储的Map默认是Map<String, dynamic>，通过map方法将值统一转为String，匹配Game类中name的类型要求。
2. 空值防护：使用??运算符处理字段缺失或为空的场景，避免运行时崩溃。
3. 数据获取方式：优先通过documentSnapshot.data()获取完整文档数据，比直接下标访问更稳妥。

如果确认Firestore中Name字段的所有值都是字符串类型，也可以使用简化版本（但无空值防护，风险较高）：

factory Game.fromDocument(DocumentSnapshot documentSnapshot) {
  final data = documentSnapshot.data() as Map<String, dynamic>;
  return Game(
    name: data['Name'] as Map<String, String>,
    id: data['id'] as String,
  );
}

内容的提问来源于stack exchange，提问作者Diego jiménez