Firebase Firestore获取reference关联文档报集合引用无效

在Firebase Firestore数据库中使用reference数据类型存储关联数据，数据结构参考：

获取用户数据后可拿到带对应ID的reference对象，但调用自定义函数获取目标club文档时触发错误。

自定义查询函数：

export const getClubById = async (id: string) => {
  const doc = collection(db, 'clubs', id)
  return doc
}

函数调用逻辑：

const userData = dbUser.data()
const club = await getClubById(userData.selectedClub.id)
console.log('club', club)

Uncaught (in promise) FirebaseError: Invalid collection reference. Collection references must have an odd number of segments, but clubs/vA7R94pX3bpHDsYIr6Ge has 2.

• API调用错误：collection()方法用于获取集合引用，要求路径段数为奇数；clubs/{clubId}是2段路径，指向单篇文档，应该用doc()方法获取文档引用。
• 逻辑缺漏：原函数仅返回了引用对象，没有调用getDoc()发起实际的数据查询，就算修正API也拿不到文档内容。
• 冗余操作：存储的selectedClub字段本身就是标准的DocumentReference类型对象，不需要手动提取ID再重新构造引用，多了一步容易出错的操作。

二选一即可，推荐第二种写法更简洁。

方案1：修正原有getClubById函数 #

替换API为doc()，补充数据查询逻辑：

import { doc, getDoc } from "firebase/firestore"

export const getClubById = async (id: string) => {
  const clubDocRef = doc(db, 'clubs', id)
  const clubDocSnap = await getDoc(clubDocRef)
  if (clubDocSnap.exists()) {
    return clubDocSnap.data()
  }
  return null
}

方案2：直接使用存储的Reference对象查询（推荐） #

不需要额外封装id传参的逻辑，直接拿字段里的引用查询即可，避免路径拼接错误：

import { getDoc } from "firebase/firestore"

const userData = dbUser.data()
const clubDocSnap = await getDoc(userData.selectedClub)
if (clubDocSnap.exists()) {
  const club = clubDocSnap.data()
  console.log('club', club)
}

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