You need to enable JavaScript to run this app. 按照官方文档调用VirusTotal v3.0文件上传API时报空文件名错误
优惠活动
大模型
产品
解决方案
定价
更多

按照官方文档调用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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.25 02:54:06