Flutter读取Firestore含点字段报错问题求解

问题原因 #

Firestore的DocumentSnapshot的[]运算符，以及默认的get()方法，会将字段名中的**点（.）**解析为嵌套文档的路径分隔符。比如result['1. email']会被误认为要读取嵌套在1字段下的email子字段，而非名为1. email的顶层字段，因此抛出字段不存在的错误。

解决方案 #

以下两种方法可以正确读取含特殊字符的字段：

方法1：使用FieldPath指定字段名

通过FieldPath.fromString()包装字段名，告诉Firestore不要解析字段名中的点，直接作为完整字段名处理：

import 'package:cloud_firestore/cloud_firestore.dart';

getData() async{
  var result = await FirebaseFirestore.instance.collection('users').doc('documentId').get();
  // 用FieldPath包装含点/空格的字段名
  var fieldValue = result.get(FieldPath.fromString('1. email'));
  print(fieldValue);
}

方法2：直接访问data()返回的原始映射

data()方法会返回文档的原始字段键值对Map，直接通过键名取值不会解析路径：

getData() async{
  var result = await FirebaseFirestore.instance.collection('users').doc('documentId').get();
  // data()可能为null，需做空安全判断
  print(result.data()?['1. email']);
}

注意事项 #

• 如果文档可能不存在，建议先判断result.exists，避免空指针异常；
• FieldPath方式更适合需要严格字段校验的场景，data()方式更简洁直接。

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