如何在Firebase云函数中通过身份证号获取Firestore用户文档？

问题根源 #

你当前的代码存在两个核心问题：

1. 查询路径错误：身份证号id_number是嵌套在data字段下的，直接用where('id_number', '==', ...)无法匹配到目标字段，必须写成where('data.id_number', '==', ...)。
2. 异步处理缺失：get()方法返回的是Promise<QuerySnapshot>，不是直接的用户对象，必须等待异步操作完成后才能提取数据。

完整解决方案（推荐用async/await） #

在Cloud Functions中使用异步函数处理查询，代码示例如下：

// Cloud Functions 可调用函数示例
exports.getUserByIdNumber = functions.https.onCall(async (data, context) => {
  const targetIdNumber = data.idNumber; // 接收传入的身份证号参数
  try {
    // 执行正确的嵌套字段查询
    const querySnapshot = await admin.firestore()
      .collection('users')
      .where('data.id_number', '==', targetIdNumber)
      .get();

    // 身份证号唯一，判断是否找到匹配用户
    if (querySnapshot.empty) {
      throw new Error('未找到匹配的用户');
    }

    // 提取第一个匹配文档的数据
    const userDoc = querySnapshot.docs[0];
    const rawUserData = userDoc.data();

    // 整理需要返回的用户数据（可按需调整结构）
    return {
      uid: rawUserData.uid, // 文档中存储的用户uid
      first_name: rawUserData.data.first_name,
      last_name: rawUserData.data.last_name,
      id_number: rawUserData.data.id_number
    };
  } catch (error) {
    throw new functions.https.HttpsError('not-found', error.message);
  }
});

关键细节说明 #

• 用await等待get()异步操作完成，确保拿到查询结果后再执行后续逻辑。
• 通过querySnapshot.docs获取匹配的文档数组，由于身份证号唯一，直接取数组第一个元素即可。
• userDoc.data()会返回文档内的所有字段（即你定义的uid和data嵌套对象）。
• 若需要Firestore文档自身的ID（和你存储在字段中的uid不同），可使用userDoc.id。

备选方案（链式调用写法） #

如果不习惯用async/await，也可以用.then()链式处理：

exports.getUserByIdNumber = functions.https.onCall((data, context) => {
  const targetIdNumber = data.idNumber;
  return admin.firestore()
    .collection('users')
    .where('data.id_number', '==', targetIdNumber)
    .get()
    .then(querySnapshot => {
      if (querySnapshot.empty) {
        throw new Error('未找到匹配的用户');
      }
      const rawUserData = querySnapshot.docs[0].data();
      return {
        uid: rawUserData.uid,
        ...rawUserData.data // 直接展开data中的所有字段
      };
    })
    .catch(error => {
      throw new functions.https.HttpsError('not-found', error.message);
    });
});

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