MVC架构下Multer上传逻辑置于路由文件的优化方案问询

在MVC架构中，确实应该将路由、控制器、工具配置解耦，以下是两种实用的优化方案：

方案一：将Multer配置抽为独立工具模块 #

把Multer的storage、destination、upload实例等配置单独封装成一个工具模块，路由和控制器按需引用，既保证职责单一，又方便复用。

步骤1：创建独立的Multer配置文件 #

新建utils/multer-config.js：

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

// 确保上传目录存在，避免Multer报错
const uploadDir = path.join(__dirname, '../uploads');
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir, { recursive: true });
}

// 配置存储引擎
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    // 自定义文件名，避免重复
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, `${uniqueSuffix}-${file.originalname}`);
  }
});

// 可选：文件类型过滤
const fileFilter = (req, file, cb) => {
  const allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
  if (allowedTypes.includes(file.mimetype)) {
    cb(null, true);
  } else {
    cb(new Error('仅支持JPG、PNG、GIF格式的图片'), false);
  }
};

// 创建并导出upload实例
const upload = multer({
  storage: storage,
  fileFilter: fileFilter,
  limits: { fileSize: 5 * 1024 * 1024 } // 限制文件大小为5MB
});

module.exports = upload;

步骤2：路由中引用配置好的upload #

routes.js：

const router = require('express').Router();
const upload = require('../utils/multer-config');
const controller = require('../controllers/controller');

router.post('/send', upload.single('image'), controller.upload_post);

步骤3：控制器专注业务逻辑 #

controller.js：

const upload_post = async (req, res, next) => {
  try {
    // 这里可以获取上传后的文件信息，比如存入数据库
    const fileInfo = req.file;
    res.status(200).json({
      message: '文件上传成功',
      filename: fileInfo.filename,
      path: fileInfo.path
    });
  } catch (err) {
    next(err);
  }
};

module.exports = { upload_post };

方案二：在控制器中封装含上传中间件的处理函数 #

如果希望路由层完全不感知上传逻辑，可以在控制器里把Multer中间件和业务处理函数绑定在一起，路由只调用封装后的方法。

控制器修改： #

controller.js：

const upload = require('../utils/multer-config');

const upload_post = async (req, res, next) => {
  try {
    res.status(200).json({
      message: '文件上传成功',
      file: req.file
    });
  } catch (err) {
    next(err);
  }
};

// 封装成包含上传中间件的数组
exports.handleImageUpload = [upload.single('image'), upload_post];

路由修改： #

routes.js：

const router = require('express').Router();
const controller = require('../controllers/controller');

// 路由只需引用封装好的处理函数，无需关心上传细节
router.post('/send', controller.handleImageUpload);

方案优势 #

• 方案一：Multer配置集中管理，多个路由或控制器都能复用同一套上传规则，便于统一修改（比如调整文件大小限制、存储路径）。
• 方案二：路由层更简洁，完全专注于URL映射，所有与该请求相关的中间件和业务逻辑都由控制器负责，符合MVC中控制器处理请求流程的职责。

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