使用Multer+MongoDB原生驱动上传图片时遇Cannot POST /students/image错误求助

问题背景 #

使用Multer结合MongoDB原生驱动实现图片上传，Postman请求时返回错误：

Cannot POST /students/image

以下是你的项目文件信息（已整理）：

app.js 核心代码 #

const express = require('express');
const { ObjectId } = require('mongodb');
require('dotenv').config();
const { connectToDb, getDb }  = require('./dbconnection');
const multer = require('multer');

const app = express();

app.use(express.json());
app.use(express.static('images'));

let db;

connectToDb((err) => {
    if(!err){
        app.listen(process.env.PORT, () => {
            console.log(`Listening on ${process.env.PORT}`);
        });
        db =  getDb();
    }
});

const storage = multer.diskStorage({
    destination: function (req, file, callback) {
      callback(null, '/images');
    },
    filename: function (req, file, callback) {
      callback(null, Date.now() + file.originalname);
    },
});
  
const upload = multer({
    storage: storage,
    limits: {
      fieldSize: 1024 * 1024 * 3,
    },
});

app.post('/students', upload.single('image'), (req, res) => {
    const student = req.body;
    db.collection('student')
    .insertOne(student)
    .then(result => {
        res.status(201).json(result);
    })
    .catch(error => {
        res.status(500).json({error: "Unable to create a new data"})
    })
});

dbconnection.js 代码 #

const {MongoClient} = require('mongodb');

let dbConnection;

module.exports = {
    connectToDb: (cb) => {
        MongoClient.connect('mongodb://localhost:27017/StudentsData')
        .then((client) => {
            dbConnection = client.db()
            return cb()
        })
        .catch(err => {
            console.log(err);
            return cb(err)
        })
    },
    getDb: () => dbConnection
}

数据库示例数据 #

[
    {
        "name": "Anand",
        "age": 25,
        "course": "computer science",
        "year of completion": 2021,
        "image": ""
    },
    {
        "name": "Bivin",
        "age": 26,
        "course": "computer science",
        "year of completion": 2021,
        "image": ""
    }
]

项目文件结构 #

images/
node_modules/
.env
app.js
dbconnection.js
package.json

修复步骤 #

1. 修正路由不匹配问题 #

你在Postman中请求的是/students/image，但代码中仅定义了/students的POST路由，这是导致错误的直接原因。

• 方案一：修改Postman请求地址为 POST http://localhost:{{你的端口}}/students
• 方案二：添加对应路由（如果业务需要/students/image路径）：

  app.post('/students/image', upload.single('image'), (req, res) => {
    // 复用原/students的逻辑，或根据需求调整
    const student = {
      ...req.body,
      image: req.file ? req.file.filename : ''
    };
    db.collection('student').insertOne(student)
      .then(result => res.status(201).json(result))
      .catch(err => res.status(500).json({error: "无法创建新数据"}))
  });
  

2. 修复Multer存储路径错误 #

当前storage.destination设置为/images（系统根目录的绝对路径），但你的项目图片文件夹在当前项目目录下，需改为相对路径：

const storage = multer.diskStorage({
    destination: function (req, file, callback) {
      // 指向项目根目录下的images文件夹
      callback(null, './images');
    },
    filename: function (req, file, callback) {
      callback(null, Date.now() + file.originalname);
    },
});

注意：确保images文件夹已存在，若不存在需手动创建，否则Multer会抛出写入错误。

3. 将图片路径存入MongoDB #

当前代码仅插入req.body的内容，未把上传的图片文件名存入student的image字段，导致数据库中该字段为空：
修改/students路由的处理逻辑：

app.post('/students', upload.single('image'), (req, res) => {
    // 合并表单数据与图片文件名
    const student = {
        ...req.body,
        // 若有文件上传则存入文件名，否则留空
        image: req.file ? req.file.filename : ''
    };

    db.collection('student')
    .insertOne(student)
    .then(result => {
        res.status(201).json({
            message: "学生数据创建成功",
            insertedId: result.insertedId
        });
    })
    .catch(error => {
        res.status(500).json({error: "无法创建新数据"})
    })
});

4. 可选：添加图片类型验证（增强安全性） #

为防止上传非图片文件，可在Multer配置中添加文件过滤器：

const upload = multer({
    storage: storage,
    limits: {
      fieldSize: 1024 * 1024 * 3, // 限制3MB
    },
    fileFilter: (req, file, cb) => {
        // 允许的图片MIME类型
        const allowedMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
        if (allowedMimes.includes(file.mimetype)) {
            cb(null, true);
        } else {
            cb(new Error("仅支持JPG、PNG、GIF、WebP格式的图片"));
        }
    }
});

Postman请求注意事项 #

发起请求时需选择form-data格式：

• 键名设置为image（对应upload.single('image')中的参数），类型选择File，上传目标图片
• 添加其他学生字段（如name、age等），类型选择Text并填入对应值

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