无法通过multer上传文件至GCP，部署Firebase Functions后报400错误

我开发了一个将文件上传至Google Cloud Storage存储桶的API，本地运行正常，但部署到Firebase Functions后返回400 Bad Request错误。

代码实现 #

const express = require("express");
const cors = require("cors");
const dotenv = require("dotenv");
const multer = require("multer");
const { Storage } = require("@google-cloud/storage");
const path = require("path");
const functions = require("firebase-functions");

dotenv.config();

const app = express();
app.use(express.json());
app.use(cors());

// Initialize Firebase and Cloud Storage
const storage = new Storage({
  keyFilename: path.join(__dirname, "test-keys.json"),
});

// Configure multer for handling file uploads
const upload = multer({
  storage: multer.memoryStorage(),
  limits: { fileSize: 10 * 1024 * 1024 }, // Limit file size to 10MB
});

// API route to upload a file
app.post("/api/uploadFile", upload.single("file"), async (req, res) => {
  try {
    const { bucketName, folder } = req.body;

    if (!req.file) {
      return res.status(400).send("No file uploaded.");
    }
    if (!bucketName || !folder) {
      return res.status(400).send("Bucket name and folder are required.");
    }

    const bucket = storage.bucket(bucketName);
    const filePath = `${folder}/${req.file.originalname}`;
    const blob = bucket.file(filePath);

    const blobStream = blob.createWriteStream({
      resumable: false,
    });

    blobStream.on("error", (err) => {
      console.error(err);
      res.status(500).send("Error uploading file.");
    });

    blobStream.on("finish", () => {
      const publicUrl = `https://storage.googleapis.com/${bucketName}/${filePath}`;
      res.status(200).send({
        message: "File uploaded successfully.",
        url: publicUrl,
      });
    });

    blobStream.end(req.file.buffer);
  } catch (error) {
    console.error(error);
    res.status(500).send("Something went wrong.");
  }
});

exports.expressApi = functions.https.onRequest(app);

const PORT = 5000;
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

已尝试操作 #

• 在本地测试API，运行正常；
• 尝试使用Multer的dest: path.join(os.tmpdir())配置，部署后问题仍存在。

1. 请求体解析冲突 #

Express的app.use(express.json())会自动解析JSON格式请求体，但Multer处理multipart/form-data类型请求时，若被express.json提前解析，会导致Multer无法正确读取文件。Firebase Functions的HTTP触发器默认解析逻辑也可能加剧这个冲突，最终触发!req.file的400错误。

解决方法：

• 将app.use(express.json())移至Multer路由之后，仅让非文件上传路由使用JSON解析；
• 或在上传路由显式禁用JSON解析：

  app.post("/api/uploadFile", express.json({ limit: '0' }), upload.single("file"), async (req, res) => {
    // 原代码逻辑
  });
  

2. 密钥文件与环境变量问题 #

部署到Firebase Functions后，test-keys.json可能未被正确包含在部署包中（比如被.gitignore或.firebaseignore排除），或者路径解析错误。另外，dotenv.config()在Firebase环境中无法读取本地.env文件，因为Firebase有独立的环境变量管理机制。

解决方法：

• 检查test-keys.json是否在部署范围内，确保它不在忽略列表中；
• 改用Firebase默认身份验证：部署在Firebase Functions中的代码可通过应用默认凭据直接访问GCS，无需手动指定keyFilename：

  // 移除keyFilename配置
  const storage = new Storage();
  

3. 请求参数传递错误 #

部署后前端可能未正确以multipart/form-data格式发送请求，或file字段名不匹配，导致Multer无法识别文件；另外，bucketName和folder如果放在JSON请求体中，也无法在multipart/form-data请求中被正确解析。

解决方法：

• 确认前端请求的Content-Type为multipart/form-data；
• 确认表单文件字段名是file，与upload.single("file")中的名称一致；
• 将bucketName和folder通过FormData对象添加，而非放在JSON请求体中。

4. 请求大小限制触发 #

Firebase Functions的HTTP请求有默认大小限制（免费版通常为10MB），若上传文件接近或超过该限制，请求会被提前截断，导致Multer无法解析完整文件，触发400错误。

解决方法：

• 检查Firebase Functions的配额设置，确认请求大小限制足够；
• 若文件较大，改用GCS直接上传方案：生成签名URL让前端直接上传至GCS，绕过Functions的请求大小限制。

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