You need to enable JavaScript to run this app. 如何使用SuperTest为multer文件上传接口编写单元测试
优惠活动
大模型
产品
解决方案
定价
更多

如何使用SuperTest为multer文件上传接口编写单元测试

问题原因

  1. 字段名不匹配:你当前.attach()使用的字段名是files,但从控制器接收的对象fieldname属性可以看出,你的multer配置实际接收的字段名是uploaded,字段名不匹配会导致multer无法正确解析文件,触发500错误。
  2. 文件路径错误:如果test.jpg的相对路径不符合测试运行时的工作目录,会导致supertest读取不到文件,请求异常。
  3. 若multer配置为接收多文件数组(使用upload.array('uploaded')),上传多个文件时需要多次调用.attach()方法传入相同字段名。

正确实现代码

1. 上传请求代码修正

const path = require('path')
// 登录逻辑保持不变
let res = await api
  .post("/login")
  .send({"username" : "user", "password": "pass"})

await supertest(app)
  .post('/upload')
  // 替换为和multer配置一致的字段名uploaded,传入文件绝对路径避免读取失败
  .attach('uploaded', path.resolve(__dirname, './test.jpg'))
  // 若需上传多个文件,多次调用attach即可:
  // .attach('uploaded', path.resolve(__dirname, './test2.jpg'))
  // 标准Cookie头首字母大写,避免部分框架识别异常
  .set('Cookie', res.headers['set-cookie'])

2. 确认multer配置匹配

你的multer-s3配置需要和接收的字段名对应,示例配置如下:

const multer = require('multer')
const multerS3 = require('multer-s3')
const { S3Client } = require('@aws-sdk/client-s3')

// 初始化S3客户端,注意检查权限、区域、桶名配置是否正确
const s3 = new S3Client({
  region: 'us-east-2',
  credentials: {
    accessKeyId: '你的AWS_ACCESS_KEY',
    secretAccessKey: '你的AWS_SECRET_KEY'
  }
})

const upload = multer({
  storage: multerS3({
    s3: s3,
    bucket: 'mybucket',
    acl: 'public-read',
    key: function (req, file, cb) {
      // 自定义S3存储的文件名
      cb(null, `${Date.now()}${file.originalname}`)
    }
  })
})

// 路由配置:接收字段名为uploaded的文件数组,最大可传10个文件
app.post('/upload', upload.array('uploaded', 10), (req, res) => {
  // 此处req.files就是你给出的格式的对象数组
  console.log(req.files)
  res.json({ success: true, files: req.files })
})

可选优化:测试时Mock S3避免真实上传

如果不需要真实上传到S3做单元测试,可以Mock multer-s3直接返回预设的文件信息,不需要依赖网络和AWS权限,以Jest为例:

jest.mock('multer-s3', () => jest.fn(() => multer.memoryStorage()))

500错误排查建议

  • 在上传接口控制器中打印req.files,如果为undefined说明字段名不匹配或multer配置错误
  • 如果req.files有值但仍然报错,检查S3客户端的权限、桶名、区域配置是否正确,是否有跨域、桶策略限制

内容的提问来源于stack exchange,提问作者user392500

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 07:45:04