Firestore报错：querySnapshot.forEach is not a function 及角色子集合查询问题

看起来你遇到的这个错误，本质是你拿到的querySnapshot并不是Firestore预期的QuerySnapshot对象，所以没有自带的forEach方法。我来帮你拆解最常见的两种原因和解决办法：

情况1：混用了Firebase不同版本的API语法 #

Firebase从v9开始改用了模块化API，如果你当前项目用的是v9+版本，但还是沿用了v8的命名空间写法，就会出现这个问题。

解决步骤： #

首先确保导入了正确的Firestore方法：

import { getDocs, collection } from "firebase/firestore";

然后修改你的代码，用模块化方式构建集合引用并获取文档：

// 用collection函数直接构建子集合引用，参数依次是db、父集合名、父文档ID、子集合名
const userRolesRef = collection(db, 'users', currentUser.uid, 'roles');
let cont = 0;
// 建议用数组存储所有角色，避免覆盖
const rolesList = [];

getDocs(userRolesRef).then((querySnapshot) => {
  querySnapshot.forEach((doc) => {
    cont++;
    const roleData = doc.data();
    rolesList.push({
      id: doc.id,
      rol: roleData.rol,
      status: roleData.status
    });
    // 这里可以根据角色做路由跳转逻辑
  });
}).catch((error) => {
  console.error('获取角色集合失败:', error);
});

情况2：使用v8命名空间SDK但存在异常或语法问题 #

如果你确实在使用v8版本（比如通过firebase.firestore()初始化的实例），那错误可能来自两个点：

1. 未捕获异步错误：如果get()请求因为权限不足、网络问题失败，then里的querySnapshot可能不是预期的对象，你需要加上catch分支捕获错误。
2. 语法遗漏：你的代码末尾少了闭合的})，这会导致语法错误，进而引发奇怪的运行时问题。

修改后的代码： #

let userRef1 = db.collection('users').doc(currentUser.uid).collection('roles');
let cont = 0;
const rolesList = [];

userRef1.get().then(function(querySnapshot) {
  // 先校验querySnapshot的有效性
  if (querySnapshot && typeof querySnapshot.forEach === 'function') {
    querySnapshot.forEach(function(doc) {
      cont++;
      const roleData = doc.data();
      rolesList.push({
        id: doc.id,
        rol: roleData.rol,
        status: roleData.status
      });
    });
  } else {
    console.log('查询结果格式异常:', querySnapshot);
  }
}).catch(function(error) {
  console.error('查询角色失败:', error);
}); // 补上之前遗漏的闭合括号

额外提醒 #

你的原代码里每次循环都会覆盖rol和rolStatus的值，最后只会保留最后一个角色的数据。如果要处理所有角色，建议用数组（比如上面的rolesList）来存储每一条角色数据，这样后续跳转路由时可以遍历所有角色做处理。

内容的提问来源于stack exchange，提问作者Iván Gonzalez