Web API以byte[]格式上传多文件仅成功上传单个的问题咨询

根因定位 #

问题核心出在客户端的请求构造逻辑上：

• 当前代码仅单次实例化ByteArrayContent、单次调用content.Add()传入单份_mediaFile字节数组，全程没有遍历所有选中的待上传文件集合，即便UI层选择了多个文件，最终构造的请求体里也只携带了1份文件数据，服务端自然只能解析到单个文件。
• 附带的代码缺陷：
  • 没有await等待PostAsync返回的异步任务完成，代码拿到未执行完成的Task对象后就继续往下走，可能出现请求还没发送完就被流程中断的问题
  • 每次上传都新建HttpClient实例，长期运行会快速耗尽系统套接字资源，引发端口占用异常
  • 存在拼写疏漏：_mediaFIleName的F大小写不规范，容易出现变量未正确赋值、取到空文件名的问题

正确实现方案 #

客户端修改 #

核心是补上多文件遍历逻辑，把所有选中的文件逐个加入多部分表单，示例代码：

// 全局复用单例HttpClient，不要每次请求新建实例
private static readonly HttpClient _sharedHttpClient = new();
private const string UploadEndpoint = "http://localhost:1000/api/home/Upload";

/// <summary>
/// 批量上传文件方法
/// </summary>
/// <param name="mediaFiles">待上传文件集合，每个元素包含文件字节数组、文件名</param>
public async Task BatchUploadAsync(List<(byte[] fileContent, string fileName)> mediaFiles)
{
    using var formContent = new MultipartFormDataContent();
    
    // 遍历所有选中的文件，逐个加入表单
    foreach (var mediaFile in mediaFiles)
    {
        var fileByteArrayContent = new ByteArrayContent(mediaFile.fileContent);
        // 所有文件统一使用"file"作为表单字段名，和服务端逻辑完全匹配
        formContent.Add(fileByteArrayContent, "file", mediaFile.fileName);
    }

    // 异步等待请求执行完成
    var response = await _sharedHttpClient.PostAsync(UploadEndpoint, formContent);
    // 按需补充响应状态校验
    response.EnsureSuccessStatusCode();
}

实现注意点：

• 所有文件统一复用相同的表单字段名"file"即可，不需要为每个文件设置独立的字段名，服务端的Request.Files集合会自动汇总所有同名字段的文件项
• 必须用await等待异步请求完成，不要直接fire-and-forget丢任务

服务端校验 #

你写的服务端遍历Request.Files的逻辑本身可以正常接收多文件，只要请求体里携带了多个同名字段的文件，循环就能遍历到所有上传项。只需要做两个小优化：

• 用Path.Combine替代字符串硬拼接的路径逻辑，避免斜杠方向不匹配的问题，原路径拼接部分可以调整为：

  var httpRequest = HttpContext.Current.Request;
  var uploadDir = HttpContext.Current.Server.MapPath("~/uploads/");
  foreach (string file in httpRequest.Files)
  {
       var postedFile = httpRequest.Files[file];
       var savePath = Path.Combine(uploadDir, postedFile.FileName);
       postedFile.SaveAs(savePath);
  }
  

• 补充文件名合法性校验，避免恶意构造的带../的文件名引发路径穿越安全问题

常见踩坑提示 #

• 如果多文件总大小超过ASP.NET/IIS的默认请求长度限制，会直接被服务端拦截返回错误，需要在对应配置节点调整最大请求长度、请求超时时间参数
• 多部分表单的边界分隔符由MultipartFormDataContent自动生成，不需要手动指定，否则会出现服务端解析失败的问题

内容的提问来源于stack exchange，提问作者דניאל