Flutter中点击按钮批量复制Firestore集合文档至另一集合的报错问题

你的问题核心出在两个关键地方：一是原函数没有返回可使用的数据（属于void类型），二是Firestore的读写操作都是异步的，你没正确处理异步流程就直接尝试使用数据，自然会触发空值错误。

第一步：改造数据获取函数，让它返回可复用的文档数据 #

把原来的documentsLoopFromFirestore()改成异步函数，返回源集合的文档数据列表，这样后续才能拿到数据去复制：

Future<List<Map<String, dynamic>>> getSourceCollectionDocs() async {
  // 异步获取源集合的快照
  QuerySnapshot snapshot = await FirebaseFirestore.instance.collection('myCollection').get();
  // 把每个文档的数据提取出来，转换成Map列表返回
  return snapshot.docs.map((doc) => doc.data() as Map<String, dynamic>).toList();
}

这里用async/await让异步代码更直观，同时通过map遍历所有文档，把每个文档的data()提取出来组成列表。

第二步：在按钮点击事件中处理异步复制流程 #

现在可以在按钮的onPressed里调用上面的函数，等待数据返回后循环写入目标集合：

Widget _button() {
  return ElevatedButton(
    onPressed: () async {
      try {
        // 等待源集合的数据加载完成
        List<Map<String, dynamic>> docsData = await getSourceCollectionDocs();
        // 循环将每条数据写入目标集合
        for (var data in docsData) {
          await FirebaseFirestore.instance.collection('myOtherCollection').add(data);
        }
        print('所有文档复制完成！');
      } catch (e) {
        // 捕获并打印可能出现的错误
        print('复制失败：$e');
      }
    },
    child: const Text('复制集合'),
  );
}

为什么之前的两种方式会报错？ #

• 方式一：documentsLoopFromFirestore()是无返回值的void函数，调用它只会执行打印操作，不会返回任何数据，所以add()拿到的是null，触发了空值检查错误。
• 方式二：同样因为原函数没有返回可遍历的列表，调用forEach()时会因为null报错；而且你没有处理异步逻辑，数据还没从Firestore拉取完成就开始尝试遍历，逻辑顺序完全错误。

额外优化：保留原文档ID（可选） #

如果你希望目标集合的文档ID和源集合完全一致（而不是Firestore自动生成新ID），可以把复制逻辑改成这样：

// 在按钮的onPressed里修改逻辑
try {
  QuerySnapshot snapshot = await FirebaseFirestore.instance.collection('myCollection').get();
  for (var doc in snapshot.docs) {
    // 使用原文档ID创建目标文档，写入数据
    await FirebaseFirestore.instance.collection('myOtherCollection').doc(doc.id).set(doc.data() as Map<String, dynamic>);
  }
  print('带ID的文档复制完成！');
} catch (e) {
  print('复制失败：$e');
}

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