Node.js如何将客户端上传的multipart/form-data文件转发至第三方接口
问题解决方案:Node.js服务端将multer读取的内存文件传递给第三方multipart接口
你遇到的报错是因为Node.js环境下的FormData实现不支持直接传入multer的文件对象,需要传入Buffer或者可读流类型的参数,结合你要求扫描完成前不落盘的需求,直接用multer内存存储的Buffer处理即可,全程不需要文件落盘。
第一步:确认multer配置为内存存储
首先要保证multer没有配置磁盘存储,而是使用内存存储,文件会存在内存的Buffer中不会落盘,符合你的业务要求:
const multer = require('multer'); // 配置内存存储 const storage = multer.memoryStorage(); // 可同时配置文件大小、类型校验 const upload = multer({ storage: storage, limits: { fileSize: 10 * 1024 * 1024 // 限制单文件最大10MB,可按需调整 }, fileFilter: (req, file, cb) => { // 你的文件类型校验逻辑 const allowedTypes = ['application/pdf', 'image/png', 'image/jpeg']; if (allowedTypes.includes(file.mimetype)) { cb(null, true); } else { cb(new Error('不支持的文件类型'), false); } } });
第二步:将文件添加到FormData
multer读取到的req.files[0]对象包含buffer(文件二进制内容)、originalname(原文件名)、mimetype(文件类型)属性,直接用buffer传入FormData即可,两种实现方式可选:
方式1:直接传入Buffer(推荐,更简单)
const FormData = require('form-data'); async function scanFiles(file) { const formData = new FormData(); try { // 第三个参数传入配置项指定文件名和文件类型 formData.append("file", file.buffer, { filename: file.originalname, contentType: file.mimetype }); } catch (err) { global.logger.error("Form data 构造失败", err); throw err; } // 后续调用第三方扫描接口逻辑 }
方式2:转成可读流传入
如果第三方接口要求必须传流格式,可以将Buffer转为可读流再传入:
const FormData = require('form-data'); const { Readable } = require('stream'); async function scanFiles(file) { const formData = new FormData(); const fileStream = Readable.from(file.buffer); try { formData.append("file", fileStream, { filename: file.originalname, contentType: file.mimetype }); } catch (err) { global.logger.error("Form data 构造失败", err); throw err; } // 后续调用第三方扫描接口逻辑 }
第三步:调用第三方接口的注意事项
发送请求时需要自动携带FormData生成的boundary请求头,不要手动写死multipart/form-data头,以axios调用为例:
const axios = require('axios'); // 接上面的formData构造逻辑 const scanRes = await axios.post('你的第三方扫描接口地址', formData, { headers: { // 自动生成带boundary的正确Content-Type头 ...formData.getHeaders() } }); return scanRes.data;
额外注意事项
- 内存存储模式下大文件会占用服务端内存,建议严格限制上传文件大小,避免服务端OOM
- 扫描完成后如果需要保存文件,直接把
req.files[0].buffer写入磁盘即可,不需要再次读取上传内容
内容的提问来源于stack exchange,提问作者Jyotirmoy Pan
相关产品推荐
相关产品推荐

