按照官方文档调用VirusTotal v3.0文件上传API时报空文件名错误
VirusTotal文件上传端点报空文件名错误的排查与解决
核心错误原因
该BadRequestError并非通过在请求体中新增name/filename普通字段就能解决:VirusTotal的/api/v3/files端点要求符合multipart/form-data规范的文件上传格式,服务端只会从上传文件块的内置元数据中读取文件名,孤立的普通表单字段不会被解析为文件的文件名信息。
当前实现中存在三个典型问题:
- 直接将本地文件路径字符串作为
file字段值传入POST数据,并未将实际文件内容以二进制流形式上传,服务端根本无法识别为有效文件,自然读不到文件名元数据 - 手动添加的
name、filename字段属于孤立的普通键值对,并未绑定到上传的文件块元数据上,完全起不到设置文件名的作用 - 若自定义的REQUEST工具未针对multipart文件上传做专门处理,会直接把所有入参序列化为urlencoded格式,进一步导致服务端无法解析文件结构
官方GUI测试时报同样错误,通常是因为上传控件未正确关联选中的本地文件,序列化表单时未将文件块的文件名元数据随请求发送。
正确的实现逻辑
构造上传请求时必须遵循以下规则:
- 不要手动硬编码
Content-Type为multipart/form-data,需让HTTP客户端根据传入的FormData对象自动生成带正确boundary标识的请求头,手动设置会导致boundary丢失,服务端解析失败 - 必须通过对应HTTP客户端的FormData API,将本地文件流绑定为
file字段的内容,在绑定过程中显式传入文件名参数,让文件名成为文件块的内置元数据
修正后的Node.js实现参考:
import { createReadStream } from 'fs'; import FormData from 'form-data'; class VirusTotal { constructor(){ this.APIKEY = CONF.virus_apikey; } async checkFile(filePath){ const url = 'https://www.virustotal.com/api/v3/files'; // 构造标准multipart表单对象 const form = new FormData(); // 绑定文件流,同时显式指定文件元数据中的文件名 form.append('file', createReadStream(filePath), { filename: filePath.split('/').at(-1) }); // 发起请求 const res = await fetch(url, { method: 'POST', headers: { 'x-apikey': this.APIKEY, ...form.getHeaders() }, body: form }); return res.json(); } }
快速验证排错步骤
- 优先通过cURL命令排除代码封装逻辑的干扰:
curl --request POST \ --url https://www.virustotal.com/api/v3/files \ --header "x-apikey: 你的API密钥" \ --form "file=@/本地测试文件的绝对路径" - 若cURL请求能正常返回文件分析的响应结果,说明API权限、网络连通性均无问题,只需调整自定义REQUEST工具的逻辑,将普通键值对传参替换为标准multipart文件上传格式即可
- 排查官方GUI测试问题时,可重新选择本地文件后观察表单payload的实际内容,确认文件块是否携带正确的文件名元数据,避免控件未正确上传文件的情况
内容的提问来源于stack exchange,提问作者fp007
相关产品推荐
相关产品推荐

