Blazor WASM多文件上传HttpPost接口无法触发问题排查

核心问题：PostAsJsonAsync不适合文件上传场景 #

PostAsJsonAsync会把请求体序列化为JSON格式，但后端的List<IFormFile>参数是基于multipart/form-data格式接收的，JSON格式无法被ASP.NET Core正确解析，导致接口根本不会被匹配触发。

具体排查修复步骤 #

• 1. 替换前端上传方式
  放弃PostAsJsonAsync，改用MultipartFormDataContent构建符合要求的上传请求：

  var content = new MultipartFormDataContent();
  foreach (var file in selectedFiles) // selectedFiles是你获取的IEnumerable<IBrowserFile>集合
  {
      var fileStream = file.OpenReadStream(maxAllowedSize: 1024 * 1024 * 50); // 限制单文件50MB，可按需调整
      var fileContent = new StreamContent(fileStream);
      fileContent.Headers.ContentType = new MediaTypeHeaderValue(file.ContentType);
      // 注意第三个参数后的参数名要和后端接口的List<IFormFile>参数名完全一致
      content.Add(fileContent, "files", file.Name);
  }
  
  var response = await httpClient.PostAsync("api/your-controller/UploadBlobs", content);
  response.EnsureSuccessStatusCode();
  

• 2. 核对前后端参数名
  后端接口的参数名必须和前端添加文件时指定的参数名一致。比如后端代码是：

  [HttpPost("UploadBlobs")]
  public async Task<IActionResult> UploadBlobs(List<IFormFile> files)
  {
      // 业务逻辑
  }
  

  前端就必须用"files"作为参数名，否则后端无法完成参数绑定。

• 3. 检查请求大小限制
  如果上传的文件过大，会被ASP.NET Core默认拦截，导致接口未触发。在Program.cs中添加全局配置：

  builder.Services.Configure<FormOptions>(options =>
  {
      options.MultipartBodyLengthLimit = 1024 * 1024 * 100; // 全局限制100MB
  });
  

  也可以在接口上单独添加特性限制：

  [HttpPost("UploadBlobs")]
  [RequestSizeLimit(1024 * 1024 * 100)]
  public async Task<IActionResult> UploadBlobs(List<IFormFile> files)
  {
      // 业务逻辑
  }
  

• 4. 确认跨域配置覆盖文件上传场景
  即使Get接口正常，Post请求可能因为跨域策略未允许multipart/form-data类型被拦截。后端跨域配置要确保：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowBlazorClient",
          policy => policy.WithOrigins("https://your-blazor-client-url")
                          .AllowAnyMethod()
                          .AllowAnyHeader()
                          .AllowCredentials());
  });
  

  并在中间件链中启用：

  app.UseCors("AllowBlazorClient");
  

• 5. 核对路由匹配是否正确
  检查前端请求的URL是否和后端路由完全匹配。比如控制器带有[Route("api/[controller]")]特性，那么请求URL应该是"api/YourControllerName/UploadBlobs"，不要漏掉控制器名称或路由前缀。

内容的提问来源于stack exchange，提问作者Venkat