如何通过Express直接将客户端文件上传至MinIO？（Node.js）

别纠结那两个报错的第三方包了，直接用 multer 配合 MinIO 官方 SDK 自定义存储引擎，兼容性和可控性都更强。下面是完整实现步骤：

1. 安装必要依赖 #

npm install express multer minio

2. 初始化 MinIO 客户端 #

替换成你的 MinIO 服务实际配置参数：

const Minio = require('minio');

const minioClient = new Minio.Client({
  endPoint: '你的MinIO服务地址', // 示例：'localhost:9000'
  port: 9000,
  useSSL: false, // 生产环境建议开启
  accessKey: '你的AccessKey',
  secretKey: '你的SecretKey'
});

3. 自定义 Multer 存储引擎 #

自己实现 multer 所需的存储方法，直接调用 MinIO 官方 API 上传：

const multer = require('multer');

const minioStorage = multer.diskStorage({
  async _handleFile(req, file, cb) {
    try {
      // 自定义文件名避免重名（时间戳+原文件名）
      const fileName = `${Date.now()}-${file.originalname}`;
      // 上传到指定 MinIO Bucket
      await minioClient.putObject('你的Bucket名称', fileName, file.stream);
      // 回调返回文件信息，后续路由可直接使用
      cb(null, {
        bucket: '你的Bucket名称',
        key: fileName,
        location: `http://你的MinIO地址/你的Bucket名称/${fileName}`
      });
    } catch (err) {
      cb(err);
    }
  },
  async _removeFile(req, file, cb) {
    // 可选：上传失败时清理已上传文件
    try {
      await minioClient.removeObject(file.bucket, file.key);
      cb(null);
    } catch (err) {
      cb(err);
    }
  }
});

// 创建 multer 中间件实例
const upload = multer({
  storage: minioStorage,
  limits: {
    fileSize: 10 * 1024 * 1024 // 限制单文件10MB，可按需调整
  }
});

4. 配置 Express 路由 #

将中间件挂载到上传接口：

const express = require('express');
const app = express();

// 单文件上传接口
app.post('/upload', upload.single('file'), (req, res) => {
  if (!req.file) {
    return res.status(400).json({ message: '请选择要上传的文件' });
  }
  res.status(200).json({
    message: '文件上传成功',
    fileInfo: req.file
  });
});

// 多文件上传接口（最多5个文件，可调整）
app.post('/uploads', upload.array('files', 5), (req, res) => {
  if (!req.files || req.files.length === 0) {
    return res.status(400).json({ message: '请选择要上传的文件' });
  }
  res.status(200).json({
    message: '文件上传成功',
    fileInfos: req.files
  });
});

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

关键注意事项 #

• 确保你的 MinIO Bucket 已创建，且客户端具备读写权限
• 文件名可根据业务需求自定义，比如哈希值、用户ID前缀等
• 可在 _handleFile 中添加文件类型校验，限制仅允许图片、文档等特定类型
• 完善错误处理，比如网络异常、权限不足等场景返回明确错误信息

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