如何在Firebase Cloud Function的onWrite()快照中添加新字段

你的代码存在几个关键问题，以下是具体修正方案：

问题分析 #

1. data.set()用法错误：change.after.data()返回的是普通JavaScript对象，并非Firestore的文档实例，因此没有set()方法，直接给对象添加属性即可。
2. 未返回异步操作Promise：云函数需要返回Promise告知Firebase异步操作完成，否则函数可能提前终止，导致数据写入失败。
3. 未处理文档删除场景：当触发onWrite的是删除操作时，change.after.data()会返回undefined，需提前判断避免报错。
4. 大整数类型兼容性：process.hrtime.bigint()生成的大整数在Firestore中存储可能存在兼容性问题，转为字符串更稳妥。

修正后的代码 #

const admin = require('firebase-admin');
const functions = require('firebase-functions');
const { getFirestore } = require('firebase-admin/firestore');

admin.initializeApp();
const db = getFirestore();

exports.locationUpdateListener = functions.region('asia-south1').firestore
    .document('location/{locationId}')
    .onWrite(async (change, context) => {
        // 处理文档删除的情况，直接返回避免报错
        if (!change.after.exists) {
            return null;
        }

        const data = change.after.data();
        // 将大整数转为字符串，避免Firestore存储兼容性问题
        const timeMilli = process.hrtime.bigint().toString();
        const id = `${data.mobile}_${timeMilli}`;

        // 直接给数据对象添加document_id字段
        data.document_id = id;

        // 返回写入操作的Promise，确保云函数等待异步任务完成
        return db.doc(`history_location/${id}`).set(data);
    });

关键修改说明 #

• 新增change.after.exists判断，过滤删除操作的触发场景。
• 将process.hrtime.bigint()结果转为字符串，保证Firestore存储的稳定性。
• 用直接赋值的方式添加document_id字段，替代错误的set()方法（也可使用扩展运算符const newData = {...data, document_id: id}创建新对象，避免修改原快照数据）。
• 返回db.doc(...).set(data)的Promise，确保Firebase等待数据写入完成后再结束函数。

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