.NET 7 Web API设置MultipartBodyLengthLimit后IFormFile仍为Null

以下是可能导致该问题的原因及对应解决方法：

• 请求Content-Type不正确
  前端上传请求必须使用multipart/form-data类型，且请求头需包含自动生成的boundary分隔符（如multipart/form-data; boundary=----WebKitFormBoundaryxxxx）。若使用其他Content-Type（如application/json），后端无法解析出IFormFile，参数会直接为Null。

• 全局配置未生效或被覆盖
  确认MultipartBodyLengthLimit配置未被后续中间件或其他代码覆盖。可在接口中手动验证配置值：

  var formOptions = HttpContext.RequestServices.GetRequiredService<IOptions<FormOptions>>().Value;
  // 输出formOptions.MultipartBodyLengthLimit确认是否为200MB对应的值
  

• 缺少接口级别的请求大小限制
  即使全局配置了MultipartBodyLengthLimit，单个接口仍需添加[RequestSizeLimit]属性，否则会被默认请求大小限制（默认30MB）拦截，导致文件无法解析：

  [HttpPost]
  [Route("Upload")]
  [RequestSizeLimit(200217728)] // 与全局配置一致的200MB
  public async Task<IActionResult> Upload(IFormFile file)
  {
      var result = await _fileService.UploadAsync(file);
      return Ok(result);
  }
  

• 前端文件字段名不匹配
  前端通过FormData.append()添加文件时，字段名必须与接口参数file完全一致。例如前端若写成FormData.append('files', file)，后端无法绑定到参数，会返回Null。

• 服务器/反向代理的大小限制拦截

  • 若部署在IIS，需修改web.config中的maxAllowedContentLength：

    <system.webServer>
      <security>
        <requestFiltering>
          <requestLimits maxAllowedContentLength="209715200" /> <!-- 200MB -->
        </requestFiltering>
      </security>
    </system.webServer>
    

  • 若使用Nginx等反向代理，需配置client_max_body_size 200M;，避免代理提前拦截大文件请求。

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