使用express-fileupload时req.files一直返回undefined该如何解决

API 探路者

2026-9-27

修复方案

req.files返回undefined的核心原因是前端表单未指定文件上传专用的编码格式，express-fileupload仅支持解析multipart/form-data类型的POST请求。

1. 前端代码修改

给form标签添加enctype="multipart/form-data"属性，修改后完整代码如下：

<form action="/api/upload" method="post" enctype="multipart/form-data">
    <label for="imgHere">file:</label>
    <input type="file" id="imgHere" name="imgHere"><br><br>
    <input type="submit">
</form>

2. 后端代码优化（可选，建议添加）

原有后端逻辑没有错误，可增加参数校验和调试配置提升可用性：

const express = require("express");
const app = express();
const fileUpload = require("express-fileupload")

// 调试阶段可开启debug参数查看解析日志，上线时关闭即可
app.use(fileUpload({
  debug: false
}))

app.post('/api/upload', function(req, res) {
  // 提前判断无文件场景，避免报错
  if (!req.files || Object.keys(req.files).length === 0) {
    return res.status(400).send('未检测到上传的文件');
  }
  // 可直接获取对应name的文件对象
  console.log(req.files.imgHere);
  res.send("uploaded.")
});

app.listen(80, function()
{
    console.log("Server loaded.")
});