Flutter + Firestore：处理Future返回空值及文档字段不存在问题

你遇到的NoSuchMethodError是因为data['items']本身就是null，直接对null调用['itemOne']操作符会触发错误——之前的??只处理最后一层的null，但中间的items字段不存在导致返回null时，链式访问已经先报错了，所以??没起到作用。

下面是几种可行的解决方案：

方法1：使用空安全访问符?.结合?? #

通过?.操作符，当左边的data['items']为null时，整个表达式直接返回null，再用??设置默认值：

String itemOne = "";

Future fetchData() async {
  try {
    await FirebaseFirestore.instance
        .collection('payment')
        .doc("check")
        .get()
        .then((DocumentSnapshot doc) {
      final Map<String, dynamic> data = doc.data() as Map<String, dynamic>;

      // 修改这一行
      itemOne = data['items']?['itemOne'] ?? "Not Found";
      
    }).then((value) => setState(
              () => isLoading = false,
            ));
  } catch (e) {
    print(e);
  }
}

方法2：逐层兜底空值 #

如果你的Dart版本不支持?.，可以给items层先兜底为空Map，再访问itemOne：

itemOne = (data['items'] ?? {})['itemOne'] ?? "Not Found";

这样即使data['items']是null，也会用空Map替代，空Map访问不存在的键会返回null，最后通过??设置默认值。

方法3：严谨的存在性检查 #

如果需要更严谨的判断（比如确认items确实是Map类型），可以先做存在性校验：

if (data.containsKey('items') && data['items'] is Map) {
  itemOne = data['items']['itemOne'] ?? "Not Found";
} else {
  itemOne = "Not Found";
}

这几种方法都能避免空值链式访问的错误，同时给不存在的字段设置替代值。

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