如何在Firebase Functions中获取POST请求Body数据（解决undefined问题）

核心原因 #

Firebase HTTP函数默认不会自动解析请求体，直接访问req.body会返回undefined；手动监听data事件时，若未正确处理Buffer拼接、JSON解析及异步等待，也无法获取有效数据。

解决方法 #

方法1：使用Express中间件（推荐）

借助Express的json()中间件自动解析JSON格式请求体，代码示例：

const functions = require("firebase-functions");
const express = require("express");
const app = express();

// 解析JSON类型的请求体
app.use(express.json());

app.post("/test", async (req, res) => {
  const id = req.body.id;
  // 日志打印获取到的ID
  functions.logger.info(`获取到的ID: ${id}`, { structuredData: true });
  // 返回响应
  res.status(200).send(`成功获取ID: ${id}`);
});

// 导出Firebase函数
exports.test = functions.https.onRequest(app);

若请求是x-www-form-urlencoded格式，需额外添加app.use(express.urlencoded({ extended: true }));

方法2：手动解析请求体（无需Express）

通过Promise包裹事件监听逻辑，确保等待请求体接收完成后再解析：

const functions = require("firebase-functions");

exports.test = functions.https.onRequest(async (req, res) => {
  // 仅处理POST请求
  if (req.method !== "POST") {
    return res.status(405).send("仅支持POST请求");
  }

  try {
    // 手动拼接并解析请求体
    const body = await new Promise((resolve, reject) => {
      let rawData = "";
      req.on("data", (chunk) => {
        rawData += chunk.toString();
      });
      req.on("end", () => {
        try {
          resolve(JSON.parse(rawData));
        } catch (err) {
          reject(new Error("请求体不是有效JSON格式"));
        }
      });
      req.on("error", reject);
    });

    const id = body.id;
    functions.logger.info(`获取到的ID: ${id}`, { structuredData: true });
    res.status(200).send(`成功获取ID: ${id}`);
  } catch (err) {
    functions.logger.error(err.message);
    res.status(400).send(err.message);
  }
});

关键注意事项 #

• 确保请求的Content-Type设置为application/json（JSON格式请求时），否则中间件或手动解析都会失败；
• 避免在异步函数中直接使用req.on事件而不等待完成，否则函数会提前结束，无法获取完整请求体。

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