如何使用JavaScript修改Firebase Database中数据的存储目录结构

该需求本质是批量读取原路径下的所有用户数据，写入目标路径后再删除原路径冗余数据，以下是可直接运行的实现方案，同时适配Web客户端JS SDK、Node.js Firebase Admin SDK两种场景。

前置准备 #

• 已完成Firebase SDK初始化，对应账号拥有数据库读写权限
• 建议先在测试环境验证逻辑，确认无误后再操作生产数据
• 数据量过大时建议分批处理，避免触发数据库流量、请求频率限制

完整实现代码 #

// 客户端JS SDK导入写法
import { getDatabase, ref, get, set, remove } from "firebase/database";
// Firebase Admin SDK导入写法（Node.js环境）
// const { getDatabase, ref, get, set, remove } = require("firebase-admin/database");

const db = getDatabase();

async function migrateEconomyItemPath() {
  try {
    // 1. 读取Users根节点下所有用户数据
    const usersRef = ref(db, 'Users');
    const usersSnapshot = await get(usersRef);

    if (!usersSnapshot.exists()) {
      console.log('Users节点无匹配数据，终止迁移');
      return;
    }

    const allUserMap = usersSnapshot.val();
    const migrateTaskList = [];

    // 2. 遍历所有用户ID，迁移对应Items数据
    Object.keys(allUserMap).forEach(userId => {
      const originItems = allUserMap[userId]?.Economy?.Items;
      // 跳过没有经济物品数据的用户
      if (!originItems) return;

      // 写入数据到目标路径
      const targetRef = ref(db, `Economy/Users/${userId}/Items`);
      migrateTaskList.push(set(targetRef, originItems));

      // --- 确认目标路径数据写入无误后，再取消下方注释删除原路径数据 ---
      // const originRef = ref(db, `Users/${userId}/Economy/Items`);
      // migrateTaskList.push(remove(originRef));
    });

    // 批量执行所有迁移任务
    await Promise.all(migrateTaskList);
    console.log('全部数据迁移完成');
  } catch (error) {
    console.error('迁移失败，错误信息：', error);
  }
}

// 执行迁移逻辑
migrateEconomyItemPath();

注意事项 #

• 代码默认注释了原路径删除逻辑，务必先验证目标路径数据完整度，再开启删除逻辑避免数据丢失
• 单批次迁移用户量超过1000时，建议拆分为多批次执行，每次处理500个用户避免请求超时
• 迁移过程中建议暂时关闭对应业务的写入口，避免迁移期间原路径新增的数据被遗漏
• 若使用客户端JS SDK执行，需确保当前登录账号拥有Users和Economy两个节点的读写权限，否则会触发权限拒绝报错

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