Firebase获取用户文档报错：无效文档引用（段数异常）

错误原因 #

你遇到的Invalid document reference错误，核心是Firebase的文档引用必须是集合名+文档ID的成对结构（段数为偶数）。当前你的引用只写了users（1段），这是集合引用而非合法的文档引用，因此触发报错。

修复方案 #

要拉取具体用户的文档，必须在集合路径后拼接用户的唯一标识（通常用登录用户的UID），构造出完整的文档路径：

// 先确保用户已登录
const currentUser = auth.currentUser;
if (currentUser) {
  // 构造合法的文档引用：集合users + 用户UID作为文档ID
  const docRef = db.collection('users').doc(currentUser.uid);
  
  // 拉取文档数据
  docRef.get().then(doc => {
    if (doc.exists) {
      const userData = doc.data();
      // 将用户名渲染到页面，比如：document.getElementById('username').textContent = userData.username;
    } else {
      console.log('该用户的文档不存在');
    }
  }).catch(err => {
    console.error('获取用户文档失败:', err);
  });
}

常见错误排查 #

• 检查你之前的代码：是不是误写了db.doc('users')？这种写法会把users当成完整文档路径，而它只有1段，不符合要求。正确的文档路径格式是集合名/文档ID（2段），如果是子集合则是集合1/文档1/集合2/文档2（4段），以此类推。
• 确认执行这段代码时用户已经完成登录，否则auth.currentUser会是null，导致无法构造正确的文档ID。

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