Node-RED中调用Firebase Firestore的setDoc报invalid-argument错误如何解决

这个错误的核心是Node-RED函数节点的沙箱执行机制导致的对象原型链不匹配。
Node-RED的函数节点运行在独立的VM沙箱环境中，你在函数节点内创建的普通对象{name: "Frank", age: 12}的Object.prototype，和你在settings.js中导入Firebase SDK时所在的Node主进程的Object.prototype不是同一个引用。Firebase Firestore SDK的setDoc/updateDoc方法会严格校验传入数据的原型，要求必须是原生JavaScript普通对象，因此会把沙箱中创建的对象识别为自定义对象，触发参数错误。
而Realtime Database的参数校验没有这个严格的原型检查，仅校验数据可序列化，所以可以正常运行。

以下方案按落地优先级排序：

• 方案1：序列化再反序列化转换对象（最便捷，优先使用）
  在传入setDoc前，将你构造的数据对象通过JSON.parse(JSON.stringify())做一次转换，即可清除沙箱对象的原型标记，转为Firebase可识别的原生对象。
  代码示例：

const ft = global.get('firebaseFirestore');
const firestore = global.get('firestore');

const data = {
    name: "Frank",
    age: 12
};
// 转换对象原型
const normalizedData = JSON.parse(JSON.stringify(data));

const frankDocRef = ft.doc(firestore, "users", "frank");
await ft.setDoc(frankDocRef, normalizedData);

• 方案2：使用结构化克隆转换对象
  如果你的数据包含JSON不支持的类型（比如Date、二进制数据等），可以用Node.js内置的structuredClone方法做转换：

const normalizedData = structuredClone(data);

• 方案3：封装Firestore写入方法到全局上下文
  如果频繁调用Firestore写入操作，可直接在settings.js中封装好写入逻辑，暴露给函数节点调用，避免在沙箱中传递对象：
  在settings.js的functionGlobalContext中添加：

functionGlobalContext: {
    // 原有配置保留
    firestoreSetDoc: async (docRef, data) => {
        const { setDoc } = require('firebase/firestore');
        return setDoc(docRef, data);
    }
}

之后在函数节点中直接调用全局暴露的firestoreSetDoc即可。

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