如何使用express-formidable保存上传至服务器的文件？

嘿，我刚好踩过这个坑，马上帮你搞定！

你遇到的[Object object]问题，是因为你直接把express-formidable返回的文件对象传给了fs.writeFile——这个方法只接受字符串、Buffer或者Uint8Array，而你传的是一个包含文件所有元信息的对象，它被自动转成了字符串[Object object]，自然不对啦。

其实express-formidable已经帮你把上传的文件存在临时目录里了，你不需要手动读取内容再写入，直接复制/移动这个临时文件到你的目标路径就好，效率还更高。下面是具体的步骤和代码示例：

正确的保存方式 #

1. 先确认依赖安装 #

确保你已经装了需要的包：

npm install express express-formidable fs path

2. 完整的示例代码 #

const express = require('express');
const formidable = require('express-formidable');
const fs = require('fs');
const path = require('path');

const app = express();

// 启用express-formidable中间件，处理上传的文件
app.use(formidable());

// 处理文件上传的POST接口
app.post('/upload', (req, res) => {
  // 这里的`file`对应前端表单里的文件字段名，比如<input type="file" name="file">
  const uploadedFile = req.files.file;

  if (!uploadedFile) {
    return res.status(400).send('请选择要上传的文件');
  }

  // 定义目标保存目录，比如项目根目录下的uploads文件夹
  const uploadsDir = path.join(__dirname, 'uploads');
  
  // 确保目录存在，不存在就创建（recursive: true支持创建多级目录）
  if (!fs.existsSync(uploadsDir)) {
    fs.mkdirSync(uploadsDir, { recursive: true });
  }

  // 目标文件路径，用原文件名保存，你也可以自定义文件名（比如加时间戳避免重复）
  const targetFileName = Date.now() + '-' + uploadedFile.name; // 避免同名覆盖
  const targetFilePath = path.join(uploadsDir, targetFileName);

  // 方法一：复制临时文件到目标路径（推荐，跨文件系统也能正常工作）
  fs.copyFile(uploadedFile.path, targetFilePath, (err) => {
    if (err) {
      console.error('保存文件出错:', err);
      return res.status(500).send('文件保存失败');
    }

    // 可选：删除临时文件（有些操作系统会自动清理临时文件，也可以留着让系统处理）
    fs.unlink(uploadedFile.path, (unlinkErr) => {
      if (unlinkErr) console.error('删除临时文件失败:', unlinkErr);
    });

    res.send(`文件保存成功！路径：${targetFilePath}`);
  });

  // 方法二：移动临时文件到目标路径（更快，但只适用于临时文件和目标路径在同一个文件系统）
  // fs.rename(uploadedFile.path, targetFilePath, (err) => {
  //   if (err) {
  //     console.error('移动文件出错:', err);
  //     return res.status(500).send('文件保存失败');
  //   }
  //   res.send(`文件保存成功！路径：${targetFilePath}`);
  // });
});

// 启动服务器
app.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

3. 为什么之前的方法不行？ #

如果你一定要用fs.writeFile，那得先读取临时文件的内容，再写入目标文件（但大文件不推荐这种方式，会占用更多内存）：

// 不推荐用于大文件
fs.readFile(uploadedFile.path, (readErr, fileData) => {
  if (readErr) {
    console.error('读取临时文件出错:', readErr);
    return res.status(500).send('读取文件失败');
  }
  fs.writeFile(targetFilePath, fileData, (writeErr) => {
    if (writeErr) {
      console.error('写入文件出错:', writeErr);
      return res.status(500).send('文件保存失败');
    }
    res.send('文件保存成功');
  });
});

额外注意事项 #

• 前端表单必须设置enctype="multipart/form-data"，否则服务器接收不到文件；
• 如果有多个文件上传，req.files会是一个包含多个文件对象的集合，需要循环处理；
• 自定义文件名时可以结合时间戳、随机字符串，彻底避免同名文件覆盖问题。

内容的提问来源于stack exchange，提问作者João Menighin