Node.js图片上传异常：req.file与req.files返回undefined

嘿，我之前也遇到过一模一样的问题，折腾了好一阵才找到原因，给你列几个最可能的排查方向和解决方法：

1. 确认目标文件夹存在且有写入权限 #

你的multer配置里用了dest: './public/files/lost/'，如果这个路径的文件夹不存在，或者Node进程没有写入权限，multer就没办法保存文件，自然req.file会是undefined。

建议换成diskStorage配置，手动确保文件夹存在：

const multer = require('multer');
const path = require('path');
const fs = require('fs');

// 自定义存储配置
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    const destDir = path.join(__dirname, './public/files/lost/');
    // 递归创建文件夹（如果不存在的话）
    fs.mkdirSync(destDir, { recursive: true });
    cb(null, destDir);
  },
  filename: (req, file, cb) => {
    // 自定义文件名，避免重名
    cb(null, Date.now() + '-' + file.originalname);
  }
});

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

2. 检查中间件与路由的挂载顺序 #

确保你是先初始化multer，再挂载对应的路由。比如在app.js里：

const express = require('express');
const app = express();
const reportRouter = require('./routes/your-report-router');

// 先初始化multer（或者在路由文件里正确初始化）
// ... 你的multer配置 ...

// 再挂载路由
app.use('/report', reportRouter);

如果路由挂载在multer初始化之前，中间件就不会生效。

3. 确认表单与multer配置的匹配度 #

你的表单里文件输入的name是image，upload.single("image")是对的，但要注意大小写完全一致（比如别写成Image或者IMG）。另外，一定要确保提交表单时确实选择了文件——如果没选文件，req.file本来就是undefined。

4. 检查multer是否正确安装 #

别笑，有时候真会忘：确认你已经执行了npm install multer --save，并且在代码里正确引入了const multer = require('multer');。

5. 添加错误处理排查问题 #

给路由加上multer的错误处理中间件，看看有没有隐藏的上传错误：

router.post("/", upload.single("image"), (req, res) => {
    console.log(req.file);
    console.log(req.files);
    // 你的其他逻辑
}, (err, req, res, next) => {
    // 捕获multer的上传错误
    console.error('上传错误:', err);
    res.status(400).send('文件上传失败，请检查文件格式或大小');
});

比如如果文件大小超过multer默认限制（1MB），也会导致req.file为undefined，同时抛出错误。

最后再确认一次表单属性 #

你的表单已经加了enctype="multipart/form-data"，method是POST，action路径也对，这部分没问题，但还是要确保没有拼写错误（比如别写成enctype="multipart/formdata"少了个横杠）。

按上面的步骤一步步排查，应该能解决问题！

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