使用NodeJS+Multer向MongoDB插入图片遇Cannot read property报错求助

首先，你碰到的Cannot read property 'userPhoto' of undefined错误主要有几个明确的原因，我来一步步帮你排查和修复：

错误根源拆解 #

1. Multer字段名不匹配+对象使用错误：你配置multer({ dest: '/public/'}).single('files')时指定的字段名是files，但代码里却试图读取req.files.userPhoto，字段名完全对不上；而且single()中间件会把单个上传文件存在req.file对象里，不是req.files（req.files是多文件上传时才会用到的）。
2. 缺少fs模块引入：代码里用了fs.readFileSync，但没提前引入fs模块，这会触发另一个报错。
3. 路径与存储逻辑问题：dest: '/public/'是绝对路径，容易引发权限问题，建议改用相对路径；同时存储图片到MongoDB时，要正确设置contentType和读取文件内容。
4. 前端表单编码缺失：如果前端表单没设置enctype="multipart/form-data"，Multer根本接收不到上传的文件，这是非常容易踩的坑。

修正后的完整代码 #

const multer = require('multer');
const mongoose = require('mongoose');
const fs = require('fs'); // 别忘了引入fs模块
const express = require('express');
const app = express();

// 连接MongoDB
mongoose.connect('mongodb://localhost:27017/mytable',{useNewUrlParser:true} )
 .then(()=> console.log("Mongodb connected"))
 .catch(err => console.error("could not connected",err));

// 定义Schema
const UserSchema =new mongoose.Schema({
 name:String,
 email:String,
 lastname:String,
 pass:String,
 phonenumber:String,
 zipcode:String,
 birthdate:String,
 img: {contentType:String,data:Buffer }
});

UserSchema.plugin(mongoosePaginate)
const User = mongoose.model('mytable', UserSchema);

// 配置Multer：指定字段名为userPhoto（要和前端input的name属性一致），存储到相对路径public/uploads
const upload = multer({ dest: 'public/uploads/' });

// 处理POST请求：使用upload.single('userPhoto')中间件
app.post('/save', upload.single('userPhoto'), (req,res)=>{
 // 打印调试信息，确认文件是否被接收
 console.log("上传的文件信息：", req.file);
 
 const userModel = new User();
 userModel.name = req.body.name;
 userModel.email = req.body.email;
 userModel.lastname = req.body.lastname;
 userModel.pass = req.body.pass;
 userModel.phonenumber = req.body.phonenumber;
 userModel.zipcode = req.body.zipcode;
 userModel.birthdate = req.body.birthdate;
 
 // 读取上传的文件内容并设置到model中
 userModel.img.data = fs.readFileSync(req.file.path);
 userModel.img.contentType = req.file.mimetype; // 用文件的原始mimetype，适配不同图片格式
 
 userModel.save(function(err,doc){
  if(err){
   console.error("保存失败：", err);
   return res.json({result:'error', message: err.message});
  }
  console.log("用户信息保存成功");
  res.json({result:'success'});
 });
});

关键注意事项 #

• 前端表单要求：你的HTML表单必须添加enctype="multipart/form-data"，否则无法上传文件，示例如下：

<form action="/save" method="POST" enctype="multipart/form-data">
  <!-- 其他表单输入字段 -->
  <input type="file" name="userPhoto" accept="image/*">
  <button type="submit">提交</button>
</form>

• 文件存储路径：dest: 'public/uploads/'会把上传的临时文件存在项目根目录的public/uploads文件夹，你需要确保这个文件夹存在，否则Multer会报错，可手动创建或者在代码里自动生成。
• MongoDB存图的建议：虽然可以把图片存在MongoDB的Buffer字段中，但对于中大型应用，更推荐把图片存在云存储（如OSS、S3），只在MongoDB里存储图片的访问URL，这样性能更好，也更易维护。

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