使用Multer、MulterS3与AWS SDK向DigitalOcean Spaces上传文件（NodeJS）

嘿，我碰到过好几次类似的情况——req.files能拿到文件，但就是没传到Spaces里，上传日志也没触发，大概率是multer-s3的配置或者中间件使用环节出了问题，咱们一步步排查：

1. 先确认AWS SDK和DigitalOcean Spaces的基础配置 #

DigitalOcean Spaces兼容S3 API，但端点和区域必须完全匹配，这是最容易踩的坑：

const s3 = new AWS.S3({
  endpoint: 'https://nyc3.digitaloceanspaces.com', // 换成你自己的Spaces区域端点，比如sgp1/ams3
  accessKeyId: '你的Access Key',
  secretAccessKey: '你的Secret Key',
  region: 'nyc3' // 和端点对应，比如sgp1
});

要是端点配错了，请求会静默失败，不会抛出明显错误，这时候你以为成功了其实根本没上传。

2. 检查multer-s3的Storage配置是否正确绑定了S3实例 #

得确保multer用的是multer-s3的storage，而不是默认的磁盘存储，同时在key回调里加个日志，看看有没有进入这个处理流程：

const upload = multer({
  storage: multerS3({
    s3: s3, // 必须是上面配置好的s3实例
    bucket: '你的Spaces Bucket名称',
    acl: 'public-read', // 按需设置，比如private
    key: function (req, file, cb) {
      console.log('开始处理文件：', file.originalname); // 这里的日志如果没打，说明storage没生效
      cb(null, `uploads/${Date.now()}-${file.originalname}`); // 指定文件在Spaces里的存储路径
    }
  })
});

如果key里的日志没出现，说明你可能在路由里用了普通的multer磁盘存储，而不是这个multer-s3的配置。

3. 核对路由里的中间件使用方式 #

很多时候问题就出在这——中间件和前端传参的字段名不匹配，或者用错了上传方法：
比如前端传的是单个文件，字段名是file，那路由应该这么写：

router.post('/upload', upload.single('file'), (req, res) => {
  console.log('上传后的文件信息：', req.file); // 正常的话这里会有location字段，就是Spaces的文件URL
  if (!req.file) {
    return res.status(400).send('没有文件被上传');
  }
  res.status(200).send({
    message: '上传成功',
    fileUrl: req.file.location
  });
});

如果是多文件，要用upload.array('files', 5)或者upload.fields([{name: 'avatar'}, {name: 'attachment'}])，而且要保证前端表单的字段名和后端完全一致。

4. 开启AWS SDK调试日志，抓请求细节 #

要是上面都没问题，就开个调试日志看看请求到底发没发出去，有没有错误：

AWS.config.logger = console; // 会打印所有S3相关的请求和响应细节

这样你能看到请求的状态码、错误信息，比如bucket不存在、权限不够之类的问题都会暴露出来。

5. 验证Spaces的权限配置 #

确保你的Access Key有该Bucket的写入权限——在DigitalOcean的API页面创建Access Key时，要给它分配Spaces的相关权限。另外，Bucket的CORS配置如果限制了域名，也可能影响，但你是后端上传的话，这个影响不大，不过也可以检查下。

快速验证小技巧 #

先绕开multer，直接用AWS SDK传个本地文件测试，确认S3配置没问题：

const fs = require('fs');
s3.upload({
  Bucket: '你的Bucket名',
  Key: 'test.txt',
  Body: fs.createReadStream('./test.txt'),
  ACL: 'public-read'
}, (err, data) => {
  if (err) {
    console.error('上传错误：', err);
  } else {
    console.log('测试上传成功，URL：', data.Location);
  }
});

这个测试能成功的话，说明S3配置没问题，问题肯定在multer-s3的配置或者中间件使用上；要是失败，就先把S3的配置搞定。

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