Flutter Firestore Riverpod数据获取问题：无法将文档存入数组

问题根源 #

Firestore的集合查询是异步操作，返回Promise对象。如果代码没有正确处理异步时序，比如在异步回调外操作数组或输出提示，会导致数组未被正确填充；一旦出现未捕获的错误，后续代码（包括循环结束提示）会直接中断执行。

错误代码示例（模拟你的场景） #

let adsArray = [];
// 异步查询，但后续代码直接同步执行
db.collection('normalads').get().then((querySnapshot) => {
  querySnapshot.forEach((doc) => {
    console.log(doc.data()); // 这里能正常打印
    adsArray.push(doc.data());
  });
});
console.log('循环结束'); // 这行会先于异步回调执行，且如果查询出错，这行不会输出

正确解决方案 #

方案1：使用async/await（代码更直观）

async function fetchNormalAds() {
  let adsArray = [];
  try {
    // 等待异步查询完成
    const querySnapshot = await db.collection('normalads').get();
    querySnapshot.forEach((doc) => {
      adsArray.push(doc.data());
      console.log(doc.data());
    });
    // 所有异步操作完成后再执行后续逻辑
    console.log('循环结束');
    console.log('已获取的广告数据：', adsArray);
    // 这里可以继续处理adsArray
  } catch (error) {
    // 捕获并处理错误，避免代码中断
    console.error('读取集合失败：', error);
  }
}

// 调用函数
fetchNormalAds();

方案2：在Promise回调内完成所有后续操作

let adsArray = [];
db.collection('normalads').get()
.then((querySnapshot) => {
  querySnapshot.forEach((doc) => {
    adsArray.push(doc.data());
    console.log(doc.data());
  });
  // 确保数组操作和提示都在异步完成后执行
  console.log('循环结束');
  console.log('已获取的广告数据：', adsArray);
  // 后续对数组的处理逻辑放在这里
})
.catch((error) => {
  // 捕获错误，避免代码中断
  console.error('读取集合出错：', error);
});

关键注意事项 #

• 所有依赖异步查询结果的逻辑（比如数组操作、结束提示）必须放在then回调内，或者async/await的同步代码块中，保证时序正确。
• 必须添加catch捕获错误，否则查询过程中出现权限问题、网络错误时，代码会直接中断，导致后续提示无法输出。

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