使用express-fileUpload上传文件时如何修改自定义保存文件名

当你在express-fileupload配置中开启useTempFiles: true时，中间件会先把用户上传的文件暂存到tempFileDir指定的临时目录，自动生成tmp-xxx格式的随机临时文件名。你当前的路由代码没有执行文件移动、重命名的持久化逻辑，最终目录里留存的就是未处理的临时文件，自然无法按自定义名称保存。

核心逻辑是拿到上传的文件对象后，调用对象自带的mv()方法，传入包含自定义文件名的完整存储路径，中间件会自动把临时文件移动到目标位置并重命名，操作完成后临时文件会自动清理。

修正后的代码示例 #

首先记得引入Node.js内置的path模块处理路径，避免跨操作系统的路径拼接错误：

const path = require('path');

// 修正后的上传路由
app.post(URL, (req, res) => {
  // 先校验是否存在上传文件
  if (!req.files?.file) {
    return res.status(400).send('未检测到有效上传文件');
  }

  const uploadFile = req.files.file;
  // 自定义文件名规则：以下示例为保留原文件后缀，拼接时间戳避免重名，可按需修改
  const fileSuffix = path.extname(uploadFile.name); // 获取原文件后缀，比如 .png/.pdf
  const saveFileName = `自定义文件命名_${Date.now()}${fileSuffix}`; // 替换为你需要的文件名即可
  // 拼接最终存储的完整路径
  const finalSavePath = path.join(__dirname, '你的实际文件存储目录', saveFileName);

  // 执行文件移动+重命名操作
  uploadFile.mv(finalSavePath, (err) => {
    if (err) {
      return res.status(500).send(`文件保存失败：${err.message}`);
    }
    res.status(200).send("Good Job");
  });
})

注意事项 #

• 如果你不需要临时文件中转逻辑，可以把中间件配置里的useTempFiles设为false，此时文件会先暂存在内存中，调用mv()时直接写入目标路径，不会生成临时文件。但大文件上传场景不推荐该配置，会占用过多服务端内存。
• 自定义文件名时建议保留原文件后缀，避免保存后的文件无法被正常识别打开。
• 文件名建议增加唯一标识（时间戳、随机字符串、上传用户ID等），避免不同用户上传同名文件时出现覆盖问题。
• 你原有代码中的req.fileUpload;是无效语句，没有实际作用，可以直接删除。

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