如何通过Cloud Function读取与编辑Firestore集合数据

核心问题说明 #

你当前的报错和功能异常主要由以下几个错误导致：

1. 入口index.js中read函数的回调参数缺失request，导致参数传递错位，read.js中拿到的第一个参数实际是请求对象，没有json方法，直接触发TypeError
2. read.js、edit.js中重复嵌套functions.https.onRequest，外层入口已经做了封装，内部只需导出业务处理函数即可
3. 读取逻辑中循环调用response.json，会触发重复响应报错，且无法返回全量数据
4. 编辑逻辑遍历全集合匹配文档ID，性能极低，且直接修改doc.data()不会同步到Firestore，对象赋值语法也写错（用了等号而非冒号）

修正后的代码实现 #

1. index.js（入口文件） #

const functions = require("firebase-functions");
const admin = require('firebase-admin');
admin.initializeApp();

const edit = require('./edit.js');
const read = require('./read.js');

exports.edit = functions.https.onRequest((request, response) => {
    return edit.edit(request, response);
});

// 补全request参数
exports.read = functions.https.onRequest((request, response) => {
     return read.read(request, response);
});

2. read.js（读取全量用户数据） #

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

exports.read = async (req, res) => {
    try {
        const snapshot = await admin.firestore().collection('UserProfile').get();
        const userList = [];
        // 先收集所有数据再统一返回
        snapshot.forEach(doc => {
            userList.push({
                id: doc.id,
                name: doc.data().name,
                dob: doc.data().dob
            });
        });
        return res.status(200).json({ result: userList });
    } catch (error) {
        return res.status(500).json({ error: error.message });
    }
};

3. edit.js（按文档ID更新用户数据） #

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

exports.edit = async (req, res) => {
    try {
        // 参数校验
        const { id, name, dob } = req.body;
        if (!id || !name || !dob) {
            return res.status(400).json({ error: '缺少必填参数：id、name、dob' });
        }
        // 直接定位目标文档，无需遍历全集合
        const userDoc = admin.firestore().collection('UserProfile').doc(id);
        const docSnapshot = await userDoc.get();
        if (!docSnapshot.exists) {
            return res.status(404).json({ error: '目标用户文档不存在' });
        }
        // 调用update方法提交更新
        await userDoc.update({ name, dob });
        return res.status(200).json({
            result: { id, name, dob }
        });
    } catch (error) {
        return res.status(500).json({ error: error.message });
    }
};

调用说明 #

• 读取接口：直接发送GET请求到函数地址即可返回全量UserProfile数据
• 编辑接口：发送POST请求，请求头设置Content-Type: application/json，请求体示例：

{
    "id": "wWXaLpiOKegAMw6Jhsdf",
    "name": "Danny Updated",
    "dob": "01/01/2000"
}

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