如何修复Firebase Firestore中Map类型metadata的反序列化问题？

问题说明 #

你的Firestore数据里metadata是字符串键值对结构，但当前代码直接用as Map<String, String>强制转换时失败，其他字段反序列化正常。

问题根源 #

Firestore返回的metadata实际类型是Map<String, dynamic>，即便所有值都是字符串，Dart也不允许直接将Map<String, dynamic>强转为Map<String, String>——泛型类型不兼容会触发类型转换错误。

修复方案 #

提供三种实用的转换方式，按需选择：

方式1：遍历转换（直观可控） #

factory StripeProductPlan.fromSnapshot(
    DocumentSnapshot<Map<String, dynamic>> snapshot) {
  final data = snapshot.data()!;
  // 先取出dynamic类型的metadata
  final metadataDynamic = data['metadata'] as Map<String, dynamic>;
  // 逐个转换值为String类型
  final metadata = metadataDynamic.map((key, value) => 
    MapEntry(key, value as String)
  );

  return StripeProductPlan(
    metaData: metadata,
    selfRef: snapshot.reference,
    name: data['name'] as String,
    role: data['role'] as String? ?? '',
    taxCode: data['taxCode'] as String? ?? '',
  );
}

方式2：cast方法（简洁高效） #

如果能确保metadata里的所有值都是字符串，用cast方法快速转换：

factory StripeProductPlan.fromSnapshot(
    DocumentSnapshot<Map<String, dynamic>> snapshot) {
  final data = snapshot.data()!;
  return StripeProductPlan(
    metaData: (data['metadata'] as Map<String, dynamic>).cast<String, String>(),
    selfRef: snapshot.reference,
    name: data['name'] as String,
    role: data['role'] as String? ?? '',
    taxCode: data['taxCode'] as String? ?? '',
  );
}

方式3：安全兼容处理（应对异常数据） #

如果担心metadata存在非字符串值或字段缺失，添加空值和类型校验：

factory StripeProductPlan.fromSnapshot(
    DocumentSnapshot<Map<String, dynamic>> snapshot) {
  final data = snapshot.data()!;
  // 处理metadata可能为null的情况，默认返回空Map
  final metadataDynamic = data['metadata'] as Map<String, dynamic>? ?? {};
  final metadata = <String, String>{};
  
  metadataDynamic.forEach((key, value) {
    // 只保留字符串类型的值，非字符串可选择忽略或转为字符串
    if (value is String) {
      metadata[key] = value;
    }
    // 可选：将非字符串值转为字符串
    // else {
    //   metadata[key] = value?.toString() ?? '';
    // }
  });

  return StripeProductPlan(
    metaData: metadata,
    selfRef: snapshot.reference,
    name: data['name'] as String,
    role: data['role'] as String? ?? '',
    taxCode: data['taxCode'] as String? ?? '',
  );
}

注意点 #

• 方式1和2要求Firestore中metadata的所有值必须是字符串，否则会抛出类型错误；
• 方式3更健壮，能兼容异常数据场景，适合数据来源不可控的情况；
• 如果metadata字段可能不存在，一定要做空值判断，避免触发空指针错误。

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