Flutter Firestore读取数据时报DocumentSnapshotPlatform无对应字段如何解决

报错根因 #

Field does not exist within the DocumentSnapshotPlatform 报错的核心是代码尝试读取的字段不存在于当前获取的Firestore文档快照中，结合你的代码，修复方案如下：

修复步骤 #

• 严格匹配字段名：Firestore字段名对大小写、空格、特殊字符完全敏感，你代码中读取的是First name字段，请先确认你的users集合下的所有文档均存在完全同名的字段，无拼写、大小写、空格数量的差异。
• 补充字段容错处理：避免集合内存在部分缺失该字段的文档触发报错，建议调用get方法时添加 fallback 默认值，或者先判断字段是否存在。
• 修复语法问题：你当前代码中Text组件的右括号未闭合，会先触发编译异常。

修复后完整代码 #

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class Test extends StatefulWidget {
  @override
  _TestState createState() => _TestState();
}

class _TestState extends State<Test> {
  final db = FirebaseFirestore.instance.collection('users').snapshots();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Test'),
      ),
      body: StreamBuilder<QuerySnapshot>(
        stream: db,
        builder: (context, snapshot) {
          if (!snapshot.hasData) {
            return const Center(
              child: CircularProgressIndicator(),
            );
          } else {
            return ListView(
              children: snapshot.data!.docs.map((doc) {
                // 字段不存在时返回默认值避免报错
                String userName = doc.get('First name') ?? '未知用户';
                return Card(
                  child: ListTile(
                    title: Text(userName)
                  ),
                );
              }).toList(),
            );
          }
        },
      ),
    );
  }
}

补充排查方法 #

如果确认字段名完全匹配仍报错，可以在遍历文档的逻辑中添加打印代码print(doc.data());，控制台会输出当前文档的全量字段和值，可直接核对你要读取的字段键名是否完全一致。

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