如何在Flutter中将大型JSON文件数据导入Cloud Firestore

1. 设计匹配的Firestore数据结构 #

根据你的JSON层级，推荐采用三级集合-文档结构，贴合数据逻辑：

• 顶层集合：states，每个文档ID为邦的名称（如Tamil Nadu），文档无额外字段，仅包含子集合cities
• 子集合cities：每个文档ID为城市名称（如Chennai），文档包含子集合localities
• 子集合localities：每个文档ID为区域名称（如Anna Nagar），文档内存储pincode字段，值为对应的邮编

如果区域数据量较小，也可简化为：将区域作为城市文档的键值对字段，但大数量场景下优先用子集合，符合Firestore性能最佳实践。

2. 使用Firebase Admin SDK批量写入（推荐大型数据） #

手动导入效率极低，用代码循环写入更高效，以下是Node.js实现示例：

2.1 准备环境 #

• 安装Node.js和npm
• 安装Firebase Admin SDK：

npm install firebase-admin

• 从Firebase控制台下载服务账号密钥（JSON格式），保存为serviceAccountKey.json

2.2 编写导入代码 #

创建importData.js文件，内容如下：

const admin = require('firebase-admin');
const fs = require('fs');

// 初始化Admin SDK
admin.initializeApp({
  credential: admin.credential.cert(require('./serviceAccountKey.json'))
});

const db = admin.firestore();

// 读取JSON数据文件
const rawData = fs.readFileSync('your-data.json');
const data = JSON.parse(rawData);

// 批量写入数据
async function importData() {
  let batch = db.batch();
  let operationCount = 0;

  for (const stateName in data) {
    const cleanedState = stateName.trim();
    const stateRef = db.collection('states').doc(cleanedState);

    for (const cityName in data[stateName]) {
      const cleanedCity = cityName.trim();
      const cityRef = stateRef.collection('cities').doc(cleanedCity);

      for (const localityName in data[stateName][cityName]) {
        const cleanedLocality = localityName.trim();
        const pincode = data[stateName][cityName][localityName].trim();
        const localityRef = cityRef.collection('localities').doc(cleanedLocality);
        
        batch.set(localityRef, { pincode });
        operationCount++;

        // 单次批量操作上限500次，达到则提交并新建批次
        if (operationCount % 500 === 0) {
          await batch.commit();
          batch = db.batch();
        }
      }
    }
  }

  // 提交剩余操作
  if (operationCount % 500 !== 0) {
    await batch.commit();
  }
  console.log('数据导入完成');
}

importData().catch(err => console.error('导入失败:', err));

2.3 执行导入 #

将你的JSON数据保存为your-data.json，与上述文件放在同一目录，运行命令：

node importData.js

3. 手动导入（适合小量数据） #

如果数据量不大，可直接通过Firebase控制台操作：

• 创建顶层集合states，添加邦名称为ID的文档
• 在邦文档下创建子集合cities，添加城市名称为ID的文档
• 在城市文档下创建子集合localities，添加区域名称为ID的文档，设置pincode字段为对应邮编

注意事项 #

• 清理JSON中字符串前后的空格（你的示例数据存在大量 trailing space，如Chennai ），避免文档ID出现无效空格
• 批量写入需注意Firestore单次操作500次的上限，代码已自动处理批次拆分
• 确保服务账号拥有Firestore写入权限（Admin SDK默认具备全权限）

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