Firebase Database报错TypeError: undefined is not an object (evaluating 'path.pieceNum_')求助

问题场景 #

开发聊天页面时使用Firebase Database存储数据，传入的聊天数据结构如下：

const chatData = {
  idService: idService,
  ServiceName: name,
  users: [idUserOwner, uid],
  messageText: messageText,
};

编写了createChat函数，期望将聊天信息存入chats节点，同时为每个用户在userChats节点下记录其参与的聊天ID，但运行时报错：TypeError: undefined is not an object (evaluating 'path.pieceNum_')

函数代码如下：

import { child, getDatabase, push, ref } from "firebase/database";
import {db} from "../../utils"

export const createChat = async (uid,chatData) => {
    const newChatData = {
        ...chatData,
        createdBy: uid,
        updatedBy: uid,
        createdAt: new Date().toISOString(),
        updatedAt: new Date().toISOString()
    };
    const newChat = await push(child(db, 'chats'), newChatData);

    const chatUsers = newChatData.users;
    for (let i = 0; i < chatUsers.length; i++) {
        const userId = chatUsers[i];
        await push(child(db, `userChats/${userId}`), newChat.key);
    }

    return newChat.key;
}

问题根源 #

1. 数据库引用初始化错误：child()方法要求第一个参数必须是有效的Firebase Database引用实例，如果../../utils中导出的db没有正确调用getDatabase(app)初始化，会导致db为undefined，触发路径解析报错。
2. API调用方式不规范：push()方法直接接收目标路径的引用即可，嵌套使用child()属于冗余写法，容易引发参数类型错误。

修复方案 #

1. 确保数据库引用正确初始化 #

在../../utils文件中，确认db的初始化代码符合规范：

import { initializeApp } from "firebase/app";
import { getDatabase } from "firebase/database";

// 替换为你的Firebase项目配置
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  databaseURL: "YOUR_DATABASE_URL",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_STORAGE_BUCKET",
  messagingSenderId: "YOUR_SENDER_ID",
  appId: "YOUR_APP_ID"
};

const app = initializeApp(firebaseConfig);
export const db = getDatabase(app); // 必须通过getDatabase获取数据库实例

2. 修正createChat函数的API调用 #

将child()替换为ref()直接创建路径引用，简化调用逻辑：

import { push, ref } from "firebase/database";
import { db } from "../../utils"

export const createChat = async (uid, chatData) => {
    const newChatData = {
        ...chatData,
        createdBy: uid,
        updatedBy: uid,
        createdAt: new Date().toISOString(),
        updatedAt: new Date().toISOString()
    };
    // 直接用ref创建chats节点的引用，再调用push
    const newChatRef = push(ref(db, 'chats'), newChatData);

    const chatUsers = newChatData.users;
    for (const userId of chatUsers) {
        // 同样用ref创建userChats下的用户节点引用
        await push(ref(db, `userChats/${userId}`), newChatRef.key);
    }

    return newChatRef.key;
}

3. 可选优化：批量写入提升性能 #

多次单独写入会增加网络开销，建议使用批量更新操作合并请求：

import { push, ref, update } from "firebase/database";
import { db } from "../../utils"

export const createChat = async (uid, chatData) => {
    const newChatData = {
        ...chatData,
        createdBy: uid,
        updatedBy: uid,
        createdAt: new Date().toISOString(),
        updatedAt: new Date().toISOString()
    };
    const newChatRef = push(ref(db, 'chats'));
    const updates = {};

    // 写入聊天主数据
    updates[`chats/${newChatRef.key}`] = newChatData;
    // 写入每个用户的聊天关联记录
    chatData.users.forEach(userId => {
        const userChatRef = push(ref(db, `userChats/${userId}`));
        updates[userChatRef.path] = newChatRef.key;
    });

    // 批量提交所有写入操作
    await update(ref(db), updates);
    return newChatRef.key;
}

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