使用Node开发无服务器函数时req.file始终为undefined的问题排查

我正在用 Node 开发无服务器函数，图片上传功能里 req.file 一直是 undefined，已经用 Postman 和 HTML 表单测试过这个 API。

路由文件 auth_routes.ts 代码 #

const router = express.Router();
const upload = multer({ storage: multer.memoryStorage() })
router.route('/registerUser').post(register);
router.post("/profilePicture/upload", upload.single('image'), uploadProfilePicture)
router.route('/registerBusiness').post(registerBusiness)

export default router

上传处理函数代码 #

export const uploadProfilePicture = asyncHandler(async (req, res) => {
    logger.info("in the service function")
    logger.info(req.body)
    const regRepo = registrationRepository(db, storage);
    if(req.file === undefined){
        res.status(StatusCode.BAD_REQUEST).json({ message: "file not present" });
        logger.error("file not present")
        throw new UploadError("file not present")
    }

    const uid:string = req.body.uid;
    try {
        logger.info("uploading image")
        const url = await regRepo.uploadProfilePicture(req.file, uid); 
        res.status(StatusCode.OK).json({ message: "upload successful", url })
    } catch (error) {
        logger.error("Error uploading image", error);
        res.status(StatusCode.INTERNAL_SERVER_ERROR).json({ message: error });
        throw new UploadError("Error uploading image")
    }
})

可能的原因及解决方法 #

• 请求头错误：必须确保请求的 Content-Type 为 multipart/form-data。Postman 中要选择 form-data 类型，HTML 表单需设置 enctype="multipart/form-data"。若使用 application/json 等其他类型，multer 无法解析文件。
• 表单字段名不匹配：upload.single('image') 指定了文件字段名为 image，上传时表单的文件字段必须与之一致——Postman 中 key 要设为 image，HTML 输入框的 name 属性也要是 image。
• 无服务器平台限制：Vercel、Netlify 等平台可能对请求体大小有默认限制，或不兼容 memoryStorage。需查看平台文档调整请求大小限制，或改用兼容的存储方式。
• 中间件顺序错误：如果主应用中先调用了 express.json() 或 express.urlencoded()，这些中间件会先解析请求体，导致 multer 无法处理 multipart/form-data 格式的数据。要保证 multer 中间件在这类解析中间件之前执行。
• 文件大小超限：multer 默认限制文件大小为 1MB，超出后会忽略文件，导致 req.file 为 undefined。可在 multer 配置中添加 limits 参数调整：

  const upload = multer({ 
    storage: multer.memoryStorage(),
    limits: { fileSize: 5 * 1024 * 1024 } // 限制为 5MB
  })
  

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