如何通过Dart代码向Firestore上传含嵌套Map列表的Map？

首先明确：Firestore不支持集合直接嵌套集合，必须遵循「集合→文档→集合」的层级结构，这就是你尝试collection('courses').collection('$k')报错的核心原因。

针对你的需求，正确的实现方式是：先在courses集合下创建以key1/key2/key3为ID的文档，再在这些文档下创建子集合，最后将数组中的Map数据添加到对应子集合中。

修正后的代码 #

void uploadCourses() async {
  final firestore = FirebaseFirestore.instance;
  // 遍历外层Map的每个key
  for (var key in coursesMap.keys) {
    // 获取courses集合下以key命名的文档（不存在会自动创建）
    final parentDocument = firestore.collection('courses').doc(key);
    // 在该文档下创建子集合（用key作为子集合名称，匹配你期望的结构）
    final subCollection = parentDocument.collection(key);
    // 遍历当前key对应的Map数组，逐个添加到子集合
    for (var itemMap in coursesMap[key]) {
      await subCollection.add(itemMap);
    }
  }
}

关键说明 #

1. 必须用async/await处理Firestore的异步操作，否则会出现数据未正确写入的情况。
2. 最终结构完全匹配你的预期：courses（集合）→ key1（文档）→ key1（子集合）→ Map1/Map2（文档）。
3. 若想给子集合统一命名（比如items），只需将parentDocument.collection(key)改为parentDocument.collection('items')即可。

备选方案（无需子集合，用文档字段存储数组） #

如果你的需求可以接受将数组直接存在文档字段中，而非子集合，可使用更简洁的写法：

void uploadCourses() async {
  final firestore = FirebaseFirestore.instance;
  for (var key in coursesMap.keys) {
    await firestore.collection('courses').doc(key).set({
      key: coursesMap[key]
    });
  }
}

这种结构下，key1文档中会有一个名为key1的数组字段，包含所有对应的Map数据。

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