Node.js 16.13.2中connect-multiparty无法获取req.files问题求助

一、当前connect-multiparty空req.files的根源修复 #

你的代码存在两个核心问题导致req.files为空：

1. 文件输入框缺少name属性 #

HTML表单中，文件输入必须指定name属性，服务器端才能识别对应的文件字段。你的EJS代码里的文件输入仅设置了id，没有name：

<input type="file" id="uploadFileInput" />

需修改为：

<input type="file" id="uploadFileInput" name="files" />

路由代码中你尝试访问req.files.files，这里的files正是对应输入框的name值，缺失该属性会导致服务器无法捕获文件字段。

2. 中间件顺序干扰（可选验证） #

body-parser无法处理multipart/form-data类型请求，若全局挂载的bodyParser.urlencoded先于connect-multiparty处理请求，可能会干扰multipart数据解析。可确保路由级的multipartMiddleware优先作用于该上传接口，或暂时注释全局的bodyParser.urlencoded测试是否解决问题。

二、验证修复效果 #

修改表单后重新测试，req.files应能正确返回上传的文件对象，后续的req.files.files.originalFilename也能正常获取文件名。

三、Node.js 16.13.2的推荐文件上传方案 #

connect-multiparty已被官方标记为废弃，存在路径遍历等安全风险，更推荐使用multer——这是Express生态中维护活跃、安全可靠的文件上传中间件，完全兼容Node.js 16.x版本。

Multer实现示例 #

1. 安装依赖：

npm install multer

2. 修改router.js：

import express from 'express';
const routers = express.Router();
import multer from 'multer';
import * as path from 'path';
import * as fs from 'fs';

// 确保上传目录存在
const uploadDir = './uploads';
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir);
}

// 配置存储规则
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    // 保留原文件名，也可自定义命名规则
    cb(null, file.originalname);
  }
});

const upload = multer({ storage: storage });

// 单文件上传，参数'files'对应表单中文件输入框的name属性
routers.post('/:name', upload.single('files'), (req, res, next) => {
  console.log("system in pageName: " + req.params.name);
  console.log(req.body, req.file); // multer用req.file存储单文件，多文件用req.files
  const filename = req.file.originalname;
  res.render('fileUploading', { title: 'After Uploading: Upload success' });
});

3. EJS表单保持修改后的（带name="files"）即可，无需额外调整。

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