Flutter获取Firebase用户数据报DocumentSnapshot字段不存在错误

你遇到的两个核心问题：Bad state: cannot get a field on a DocumentSnapshotPlatform which does not exist报错、底部导航栏头像加载失败，可通过以下步骤逐一修复：

核心报错原因 #

• StreamBuilder未做数据合法性校验，未判断文档是否存在、字段是否为空就直接读取
• 新版Firebase SDK不推荐直接通过snapshot['key']读取字段，需先取出data对象再读取
• 字段拼写和Firebase控制台存储的字段名不匹配，或字段不存在
• 底部导航头像读取的是异步请求返回的属性，请求未完成时属性为null，且未监听数据更新不会自动刷新

分步修复方案 #

1. 修复Profile.dart中StreamBuilder的判断逻辑 #

补充错误、空数据、文档不存在的校验，提前解析数据再传递给子组件：

builder: (context, snapshot) {
  if (snapshot.connectionState == ConnectionState.waiting) {
    return const Center(child: CircularProgressIndicator());
  }
  // 新增异常分支判断
  if (snapshot.hasError) {
    return Center(child: Text('加载失败：${snapshot.error}'));
  }
  if (!snapshot.hasData || !snapshot.data!.exists) {
    return const Center(child: Text('用户数据不存在'));
  }
  // 提前将文档数据转为Map
  final userData = snapshot.data!.data() as Map<String, dynamic>;
  return Column(
    children: [
      Provider.of<ProfileHelpers>(context, listen: false).headerProfile(context, userData)
    ],
  );
}

2. 修改headerProfile方法入参与字段读取逻辑 #

将入参改为提前解析好的Map，同时给字段加默认值避免空值报错：

// 入参从DocumentSnapshot改为Map
Widget headerProfile(BuildContext context,  Map<String, dynamic> userData) {
  // 提前读取字段并设置兜底默认值
  final userImage = userData['userimage'] ?? 'https://via.placeholder.com/150';
  final userName = userData['username'] ?? '未设置用户名';
  final userEmail = userData['useremail'] ?? '未绑定邮箱';
  return SizedBox(
    height: MediaQuery.of(context).size.height * 0.25,
    width: MediaQuery.of(context).size.width,
    child: Row(
      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
      children: [
        Expanded(
          child: Container(
            height: 200.0,
            width: 180.0,
            child: Column(
              children: [
                GestureDetector(
                  onTap: () {},
                  child: CircleAvatar(
                    backgroundColor: constantColors.transperant,
                    radius: 60.0,
                    // 替换为提前处理好的变量
                    backgroundImage: NetworkImage(userImage),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.only(top: 8.0),
                  child: Text(userName,
                      style: TextStyle(
                          color: constantColors.whiteColor,
                          fontWeight: FontWeight.bold,
                          fontSize: 16.0)),
                ),
                Padding(
                  padding: const EdgeInsets.only(top: 8.0),
                  child: Row(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Icon(EvaIcons.email, color: constantColors.greenColor),
                      Padding(
                        padding: const EdgeInsets.only(left:9.0),
                        child: Text(userEmail,
                            style: TextStyle(
                                color: constantColors.whiteColor,
                                fontWeight: FontWeight.bold,
                                fontSize: 13.0)),
                      ),
                    ],
                  ),
                ),
              ],
            ),
          ),
        ),
        // 剩余原有代码无需修改
      ],
    ),
  );
}

3. 修复FirebaseOperations.dart的空值处理 #

给读取的用户属性加默认值，避免空值：

Future initUserData(BuildContext context) async {
  return FirebaseFirestore.instance
      .collection('users')
      .doc(Provider.of<Authentication>(context, listen: false).getUserUid)
      .get()
      .then((doc) {
        if (!doc.exists) return;
        print('Fetching user data...');
        final data = doc.data() as Map<String, dynamic>;
        initUserName = data['username'] ?? '未设置用户名';
        initUserEmail = data['useremail'] ?? '未绑定邮箱';
        initUserImage = data['userimage'] ?? 'https://via.placeholder.com/150';
        print(initUserName);
        print(initUserEmail);
        print(initUserImage);
        notifyListeners();
      });
}
// 原有getter逻辑不变

4. 修复底部导航栏头像加载问题 #

开启状态监听，加空值兜底，同时首页初始化时主动触发用户数据拉取：

1. 调整底部导航栏头像的读取逻辑：

CustomNavigationBarItem(
    icon: CircleAvatar(
  radius: 35.0,
  backgroundColor: constantColors.blueGreyColor,
  // listen改为true监听数据变化，加默认值兜底
  backgroundImage: NetworkImage(Provider.of<FirebaseOperations>(context, listen: true).initUserImage ?? 'https://via.placeholder.com/150'),
)),

2. 在Homepage.dart的State中新增初始化方法，进入首页就拉取用户数据：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    Provider.of<FirebaseOperations>(context, listen: false).initUserData(context);
  });
}

额外校验 #

如果修改后仍报字段不存在错误，直接打开Firebase控制台的users集合，核对对应用户文档的三个字段拼写是否完全一致（区分大小写），拼写不一致也会触发该报错。

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