Flutter读取Firestore报DocumentSnapshotPlatform字段不存在错误求助

报错根因 #

Cannot get a field on DocumentSnapshotPlatform which does not exist报错触发原因分为两类：

1. 你要查询的uid对应的customer集合下的文档不存在
2. 文档存在但没有name字段，或是字段名拼写/大小写不匹配

同时你的代码存在3处逻辑疏漏，也会间接触发报错：

• FirebaseAuth.instance.currentUser是同步获取属性，不需要加await，你写的getUserData方法中await语法使用错误
• 直接用user!.uid强制非空，没有做空判断兜底，用户未登录场景会直接崩溃
• 获取到DocumentSnapshot后没有校验文档是否存在，直接取字段会触发不存在的报错

修复后代码 #

class Profile extends StatefulWidget {
  @override
  _ProfileState createState() => _ProfileState();
}

class _ProfileState extends State<Profile> {
  User? user = FirebaseAuth.instance.currentUser;
  Future<String>? _title;

  @override
  void initState() {
    super.initState();
    // 先校验用户是否登录，再调用获取用户名的方法
    if (user != null) {
      _title = _getAppBarName();
    }
  }

  // 从Firestore获取用户名
  Future<String> _getAppBarName() async {
    final DocumentSnapshot ds = await FirebaseFirestore.instance
        .collection('customer')
        .doc(user!.uid)
        .get();
    // 先判断文档是否存在
    if (ds.exists) {
      // 再判断是否包含name字段，同时做类型转换
      final data = ds.data() as Map<String, dynamic>?;
      if (data != null && data.containsKey('name')) {
        return data['name'] as String;
      }
    }
    // 兜底返回默认值
    return "未设置用户名";
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // AppBar用FutureBuilder渲染异步获取的标题
      appBar: AppBar(
        title: FutureBuilder<String>(
          future: _title,
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.done && snapshot.hasData) {
              return Text(snapshot.data!);
            }
            return const Text("加载中");
          },
        ),
      ),
      body: const Center(child: Text("个人页面")),
    );
  }
}

额外校验建议 #

如果修复后依然报错，可直接在_getAppBarName方法中打印ds.data()的完整值，确认文档结构和字段名是否符合预期。

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