使用Multer自定义存储结合Sharp时触发非法操作报错

嘿，这个错误Error: EISDIR: illegal operation on a directory, open 'C:\...\uploads'其实指向性很强——你的代码正把uploads目录当成单个文件来操作，这肯定行不通。结合你用Multer自定义存储+Sharp处理图片的场景，大概率是这几个环节出了问题，咱们一步步排查修复：

1. 先查customStorage.js的路径逻辑 #

Multer的自定义存储要求你必须指定完整的文件路径（目录+文件名），如果你的_handleFile方法里只传了目录路径给Sharp，就会触发这个错误。

举个大概率你踩坑的错误写法：

// 错误示例：只给了目录，没加文件名
class CustomStorage {
  _handleFile(req, file, cb) {
    const filePath = path.join(__dirname, 'uploads');
    // 这里尝试把目录当文件打开，直接触发EISDIR
    sharp(file.stream)
      .resize(300, 300)
      .toFormat('jpeg')
      .toFile(filePath, (err, info) => {
        if (err) return cb(err);
        cb(null, { path: filePath, size: info.size });
      });
  }
}

修复方式：生成唯一文件名，拼接完整路径 #

修改自定义存储逻辑，每次上传都生成唯一文件名，组合成完整的文件路径：

// 正确的customStorage.js示例
const path = require('path');
const sharp = require('sharp');
const { v4: uuidv4 } = require('uuid'); // 用uuid生成不重复的文件名

class CustomStorage {
  constructor() {
    this.destDir = path.join(__dirname, 'uploads');
    // 确保uploads目录存在，避免目录缺失导致的额外错误
    require('fs').mkdirSync(this.destDir, { recursive: true });
  }

  _handleFile(req, file, cb) {
    // 生成唯一文件名，比如：abc123.jpg
    const fileName = `${uuidv4()}.jpg`;
    const fullFilePath = path.join(this.destDir, fileName);

    sharp(file.stream)
      .resize(300, 300)
      .toFormat('jpeg')
      .toFile(fullFilePath, (err, info) => {
        if (err) return cb(err);
        // 返回前端需要的路径，这里用相对路径示例
        cb(null, { path: `/uploads/${fileName}`, size: info.size });
      });
  }

  _removeFile(req, file, cb) {
    // 可选：实现删除文件的逻辑，方便后续出错时清理
    require('fs').unlink(path.join(this.destDir, file.path), cb);
  }
}

module.exports = new CustomStorage();

2. 检查Routes.js里的Multer配置 #

别犯“同时指定storage和dest”的低级错误，这两个配置互斥，同时用会导致路径逻辑混乱：

错误示例：重复配置冲突 #

// 错误写法：同时加了dest和storage
const multer = require('multer');
const customStorage = require('./customStorage');

const upload = multer({
  dest: './uploads', // 这里和自定义存储的路径冲突了
  storage: customStorage
});

router.post('/upload', upload.single('image'), (req, res) => {
  res.json({ file: req.file });
});

修复方式：只保留自定义存储配置 #

// 正确的Routes.js示例
const multer = require('multer');
const customStorage = require('./customStorage');

// 只使用自定义存储，不要加dest参数
const upload = multer({ storage: customStorage });

router.post('/upload', upload.single('image'), (req, res) => {
  if (!req.file) {
    return res.status(400).json({ error: '请选择要上传的图片' });
  }
  res.json({ 
    message: '图片上传并处理完成',
    file: req.file 
  });
});

3. 额外排查点 #

• 确认uploads目录存在：用mkdirSync({ recursive: true })可以自动创建不存在的目录，避免路径找不到的问题。
• 文件名别带特殊字符：如果不用uuid自定义文件名，要避开/、\这类路径分隔符，防止被解析成子目录。
• 权限检查：Windows一般没问题，Linux/macOS下要确保Node进程有读写uploads目录的权限（可以用chmod 755 uploads调整）。

按照上面的步骤调整后，应该就能解决EISDIR的错误，顺利实现上传时自动缩放+格式转换的需求了。

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