同一路由器下Node.js Express无法捕获邻机POST文件请求求助

我之前也碰到过类似的局域网文件上传问题，咱们一步步来排查可能的原因：

1. 确认Postman的表单字段名完全匹配 #

你的multer配置里用了save.single('somefile')，这意味着请求里的表单字段名必须完全一致（包括大小写）。本地测试时可能是复制了正确的配置，但另一台设备的Postman里，有没有不小心把字段名写成someFile、file或者其他拼写？只要字段名不匹配，multer就识别不到文件，req.file自然会是undefined。

2. 检查请求的Content-Type是否正确 #

上传文件的请求必须使用multipart/form-data类型的Content-Type。本地测试时Postman可能自动帮你设置了，但另一台设备的Postman可能误选了raw、application/json等其他类型——这种情况下multer根本无法解析文件，自然拿不到req.file。

在Postman里要确保：

• 请求方法是POST
• 选择form-data选项卡
• 字段类型选File，然后选择要上传的文件

3. 验证服务器监听地址是否正确 #

虽然你说另一台设备能返回200，但还是要确认你的Express启动代码是不是监听了0.0.0.0而不是localhost：

// 正确：监听所有可用网络接口，支持局域网访问
app.listen(8888, '0.0.0.0');

// 错误：只监听本机回环地址，局域网设备理论上无法访问（部分系统可能有特殊转发，但不推荐）
app.listen(8888, 'localhost');

如果是后者，虽然可能返回200，但请求处理可能存在上下文问题，导致multer无法正常解析。

4. 添加multer错误捕获，排查隐藏问题 #

当前代码没有处理multer的错误，局域网请求时可能存在隐藏的错误（比如文件大小超限、权限问题）但没被输出。可以修改路由，添加错误处理逻辑：

router.post('/save', (req, res, next) => {
  save.single('somefile')(req, res, (err) => {
    if (err) {
      console.error('Multer解析错误:', err);
      return res.status(400).send('文件上传失败：' + err.message);
    }
    next();
  });
}, (req, res) => {
  console.log(req.file);
  res.send('文件上传成功');
});

这样如果multer有错误，就能在控制台看到具体原因，方便定位问题。

5. 检查文件大小限制 #

multer默认的单个文件大小限制是1MB，如果另一台设备上传的文件超过这个大小，multer会自动忽略文件，导致req.file为undefined。可以在multer配置里调整限制：

var save = multer({ 
  storage: storage,
  limits: { fileSize: 10 * 1024 * 1024 } // 设置为10MB，按需调整
});

6. 改用绝对路径存储文件 #

当前你用的是相对路径./uploads/，虽然本地测试正常，但在某些场景下（比如服务器进程的工作目录不同）可能会导致路径错误。可以改用绝对路径更稳妥：

const path = require('path');

var storage = multer.diskStorage({ 
  destination: function (req, file, cb) { 
    // __dirname是当前脚本所在目录，确保uploads文件夹路径正确
    cb(null, path.join(__dirname, '../uploads/')); 
  }, 
  filename: function (req, file, cb) { 
    cb(null, Date.now() + path.extname(file.originalname)); 
  }, 
}); 

先从前面2个最简单的点排查（字段名、Content-Type），这两个是最常见的原因，大概率能解决你的问题。

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