如何使用SuperTest为multer文件上传接口编写单元测试
问题原因
- 字段名不匹配:你当前
.attach()使用的字段名是files,但从控制器接收的对象fieldname属性可以看出,你的multer配置实际接收的字段名是uploaded,字段名不匹配会导致multer无法正确解析文件,触发500错误。 - 文件路径错误:如果
test.jpg的相对路径不符合测试运行时的工作目录,会导致supertest读取不到文件,请求异常。 - 若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
相关产品推荐
相关产品推荐

