如何在Firebase Cloud Functions中获取POST参数？Postman测试返回undefined

嘿，我之前也踩过这个坑！Firebase Cloud Functions的HTTP触发器默认不会自动解析application/x-www-form-urlencoded类型的请求体，这就是你直接拿req.body.username会得到undefined的核心原因。下面给你两种靠谱的解决办法：

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

如果你的函数后续可能需要处理更多HTTP请求场景，用Express来封装是最省心的，它自带的urlencoded中间件可以自动帮你解析form数据。

import * as functions from "firebase-functions";
import * as express from "express";

// 创建Express实例
const app = express();

// 配置中间件，解析application/x-www-form-urlencoded类型的请求体
// extended: true 支持解析嵌套的键值对，false只支持简单键值对，根据需求选
app.use(express.urlencoded({ extended: true }));

// 定义你的POST接口
app.post("/get-username", (req, res) => {
  // 现在就能正常拿到username参数了
  const username = req.body.username;
  
  if (username) {
    res.status(200).send(`成功获取用户名：${username}`);
  } else {
    res.status(400).send("请传入username参数");
  }
});

// 将Express app绑定到Firebase Cloud Function
export const getUserInfo = functions.https.onRequest(app);

方法二：手动解析请求体（轻量场景） #

如果不想引入Express依赖，也可以手动读取请求流并解析form数据，Node.js自带的querystring模块就能搞定：

import * as functions from "firebase-functions";
import * as querystring from "querystring";

export const getUsername = functions.https.onRequest((req, res) => {
  // 先校验请求类型是否为form-urlencoded
  const isFormEncoded = req.headers["content-type"]?.includes("application/x-www-form-urlencoded");
  
  if (!isFormEncoded) {
    return res.status(400).send("仅支持application/x-www-form-urlencoded类型的请求");
  }

  // 手动读取请求体流
  let rawBody = "";
  req.on("data", (chunk) => {
    rawBody += chunk.toString();
  });

  req.on("end", () => {
    // 解析form数据为对象
    const parsedData = querystring.parse(rawBody);
    const username = parsedData.username as string;
    
    res.send(`获取到的用户名：${username || "未传入"}`);
  });
});

测试注意事项 #

在Postman里测试时，别忘了这几点：

• 请求方法选择POST
• 切换到Body标签页，选择x-www-form-urlencoded选项
• 正确添加username键和对应的测试值
• 不用手动修改Content-Type请求头，Postman会自动帮你设置为application/x-www-form-urlencoded

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