Postman二进制方式上传文件至ASP.NET MVC控制器无法接收问题排查

这个问题我之前也碰到过，核心原因是ASP.NET MVC的Request.Files只认multipart/form-data格式的上传请求，而你用Postman二进制上传时，请求的格式完全不一样，所以控制器自然拿不到文件。

问题根源拆解 #

• Request.Files的工作逻辑：Request.Files是ASP.NET专门用来解析multipart/form-data类型请求的，也就是你用Form-data上传时的格式——这种请求会把文件和其他表单字段用分隔符打包，ASP.NET会自动把其中的文件部分解析成HttpFileCollection，所以你能直接从Request.Files里拿到文件。
• 二进制上传的请求结构：当你在Postman里选「二进制」上传时，请求的Content-Type是文件对应的MIME类型（比如image/jpeg），整个请求体就是文件的原始字节流，没有Form-data里的分隔符、字段名这些结构。ASP.NET不会把这种纯字节流识别为「文件上传」，所以Request.Files.Count就是0。

解决方案 #

根据你的需求，有两种处理方式：

1. 修改控制器代码，直接读取请求体的字节流

既然二进制上传是把文件内容直接放在请求体里，那我们可以直接从Request.InputStream里读取内容：

[HttpPost]
public ActionResult Test()
{
    // 先检查请求体是否有内容
    if (Request.ContentLength > 0)
    {
        using (var memoryStream = new MemoryStream())
        {
            // 把输入流复制到内存流
            Request.InputStream.CopyTo(memoryStream);
            // 转换成字节数组，方便后续处理（比如保存到磁盘）
            var fileBytes = memoryStream.ToArray();
            
            // 示例：保存文件到本地
            // var savePath = Server.MapPath("~/Uploads/binary_upload.jpg");
            // System.IO.File.WriteAllBytes(savePath, fileBytes);
            
            return Json("OK! Received file from binary upload");
        }
    }
    else
    {
        return Json("No file Received");
    }
}

2. 同时支持Form-data和二进制上传

如果需要你的接口兼容两种上传方式，可以在Action里判断请求的Content-Type，分别处理：

[HttpPost]
public ActionResult Test()
{
    // 处理Form-data上传
    if (Request.ContentType.StartsWith("multipart/form-data"))
    {
        if (Request.Files.Count > 0)
        {
            var uploadedFile = Request.Files[0];
            // 示例：保存Form-data上传的文件
            // var savePath = Server.MapPath($"~/Uploads/{uploadedFile.FileName}");
            // uploadedFile.SaveAs(savePath);
            
            return Json($"OK! Received file from Form-data: {uploadedFile.FileName}");
        }
        return Json("No file Received in Form-data");
    }
    // 处理二进制上传
    else if (Request.ContentLength > 0)
    {
        using (var memoryStream = new MemoryStream())
        {
            Request.InputStream.CopyTo(memoryStream);
            var fileBytes = memoryStream.ToArray();
            
            // 可以通过Content-Type推断文件扩展名
            var fileExtension = Request.ContentType.Split('/')[1];
            var fileName = $"binary_upload.{fileExtension}";
            // var savePath = Server.MapPath($"~/Uploads/{fileName}");
            // System.IO.File.WriteAllBytes(savePath, fileBytes);
            
            return Json($"OK! Received binary file: {fileName}");
        }
    }
    return Json("No file Received");
}

内容的提问来源于stack exchange，提问作者Mr.Kao