如何使用multer.diskStorage将Docx文件保存到服务端public目录

• 使用技术栈：NodeJS、Express
• 业务逻辑：React端通过docx-templater结合模板将表单响应内容转换为docx文件后提交到服务端，目前已实现docx文件存入MongoDB、触发用户本地下载的功能，现需要额外通过multer将文件存储到服务端本地public文件夹。
• 异常现象：文件始终无法保存到服务端public目录下，控制台无任何报错。

路由控制器代码 #

router.post(
  "/upload",
  uploadMiddleware,
  uploadMulter.single("myFile"),
  async (req, res) => {
    console.log(req.file);
    const { file } = req;
    const { id } = file;
    try {
      if (file.size > 5000000) {
        deleteDocx(id);
        return res.status(400).send("file may not exceed 5mb");
      }
    } catch (err) {
      return res.status(201).json(err);
    }

    return res.send(file.id);
  }
);

Multer配置代码 #

const multerStorage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, `./public/docx`);
  },
  filename: (req, file, cb) => {
    cb(null, file.filename + "." + file.mimetype);
  },
});

const uploadMulter = multer({
  storage: multerStorage,
});

• 尝试使用fs模块的createWriteStream方法写入文件
• 尝试修改存储路径为/public/docx或${__dirname}/public/docx
• 已提前创建public、docx目录，排除目录不存在导致的写入失败

1. 中间件顺序错误 #

Multer的作用是解析multipart/form-data类型请求、提取上传文件，必须放在所有消费请求流的中间件之前。当前路由中uploadMiddleware在uploadMulter.single("myFile")之前执行，如果uploadMiddleware已经读取过请求流（比如解析文件存MongoDB、处理下载逻辑），请求流被消费后multer无法再读取到文件数据，不会执行本地写入逻辑，也不会抛出错误。
修复方式：将multer中间件移到路由处理链最前端，优先解析上传文件：

router.post(
  "/upload",
  uploadMulter.single("myFile"), // 移到最前面先解析文件
  uploadMiddleware,
  async (req, res) => {
    // 原有业务逻辑保持不变
  }
);

2. 路径与文件名配置错误 #

• 相对路径./public/docx是相对于Node进程启动目录的路径，不是相对于当前配置文件的路径，进程启动目录变化时会出现路径匹配错误。
• diskStorage的filename回调执行阶段，multer还未完成文件处理，file对象上不存在filename属性，读取结果为undefined；同时file.mimetype是完整MIME字符串（docx格式对应值为application/vnd.openxmlformats-officedocument.wordprocessingml.document），不是文件后缀，直接拼接会生成非法文件名，导致文件写入失败。
  修复方式：引入Node内置path模块处理绝对路径，使用合法的文件命名规则：

const path = require('path');

const multerStorage = multer.diskStorage({
  destination: (req, file, cb) => {
    // 拼接绝对路径，彻底规避进程启动目录对路径匹配的影响
    cb(null, path.resolve(__dirname, './public/docx'));
  },
  filename: (req, file, cb) => {
    // 生成唯一文件名，固定docx后缀，避免非法字符、重名覆盖问题
    const uniqueName = `${Date.now()}-${file.originalname.replace(/\s/g, '')}`;
    cb(null, uniqueName.endsWith('.docx') ? uniqueName : `${uniqueName}.docx`);
  },
});

3. 补充multer层校验 #

将文件大小、格式校验直接配置在multer层，从源头拦截非法文件，减少后续业务逻辑判断：

const uploadMulter = multer({
  storage: multerStorage,
  fileFilter: (req, file, cb) => {
    const isDocx = file.mimetype === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
    if (!isDocx) return cb(new Error('仅支持上传docx格式文件'), false);
    cb(null, true);
  },
  limits: {
    fileSize: 5 * 1024 * 1024 // 直接在multer层限制5MB大小
  }
});

修复完成后重启Node服务，再发起上传请求即可在public/docx目录下看到对应存储的文件。

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