Firebase Firestore数组无法持久化：Cloud Function数据存储异常

你遇到的问题核心在于**Array.forEach()并不支持异步等待**——当你用await emails.forEach(async (email) => {...})时，forEach只会遍历数组并触发每个异步查询任务，但不会等待所有这些异步任务执行完毕。

具体来说，代码执行顺序是这样的：

1. 触发forEach循环，给每个email发起Firestore查询（但这些查询是异步的，还没返回结果）
2. forEach循环“快速走完”，代码直接跳到创建newSession和执行sessionsRef.set()的步骤
3. 这时候studentIds还是初始的空数组（或者还没被填充完），所以写入Firestore时就是空的
4. 后续异步查询陆续完成，studentIds才被填充，但这时候写入操作已经结束了——你看到的日志里studentIds有值，是因为日志是异步任务完成后才打印的，晚于写入操作

而emails是你已经拿到的同步数组，所以能正常写入，这也侧面验证了问题出在异步执行顺序上。

有两种常用的修复方式，都能确保所有查询完成后再执行写入操作：

方式1：用for...of循环（顺序执行查询） #

for...of原生支持await，会等待每个异步操作完成后再进入下一次循环：

// 替换原来的forEach循环
for (const email of emails) {
  try {
    const student = await usersRef.where('userEmail', '==', email).get();
    if (student.empty) {
      console.log(`No matching documents for email: ${email}`);
    } else {
      student.forEach((s) => {
        const studentData = s.data();
        console.log('found student: ', studentData);
        studentIds.push(studentData.playerUniqueID);
      });
    }
  } catch (err) {
    console.log('Error finding students: ', err);
    throw new functions.https.HttpsError('internal', 'Error finding students');
  }
}

方式2：用Promise.all()（并行执行查询，效率更高） #

把每个查询包装成Promise，然后等待所有Promise完成，这种方式可以同时发起所有查询，比顺序执行更快：

// 替换原来的forEach循环
await Promise.all(emails.map(async (email) => {
  try {
    const student = await usersRef.where('userEmail', '==', email).get();
    if (!student.empty) {
      student.forEach((s) => {
        const studentData = s.data();
        console.log('found student: ', studentData);
        studentIds.push(studentData.playerUniqueID);
      });
    } else {
      console.log(`No matching documents for email: ${email}`);
    }
  } catch (err) {
    console.log('Error finding students: ', err);
    throw new functions.https.HttpsError('internal', 'Error finding students');
  }
}));

你可以在执行sessionsRef.set()之前添加一行日志：

console.log('studentIds ready for write: ', studentIds);

如果这时候日志显示数组已经被正确填充，就说明问题解决了，写入Firestore时也会保存完整的studentIds数组。

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