.NET 6 API报Multipart body length limit exceeded错误求助

以下是针对该问题的排查步骤和遗漏配置检查点：

1. 确认.NET全局FormOptions配置完整性 #

你可能遗漏了MultipartHeadersLengthLimit的配置，该值控制多部分请求头的最大长度，未设置也会触发类似错误。完整的全局配置如下：

builder.Services.Configure<FormOptions>(options =>
{
    options.ValueLengthLimit = int.MaxValue;
    options.MultipartBodyLengthLimit = int.MaxValue;
    options.MultipartHeadersLengthLimit = int.MaxValue; // 新增此配置
});

同时检查目标Action是否单独配置了[RequestFormLimits]特性，如果有，需确保其参数值与全局配置一致，避免局部覆盖全局设置：

[HttpPost("upload")]
[RequestFormLimits(MultipartBodyLengthLimit = int.MaxValue)] // 需与全局配置匹配
public IActionResult Upload([FromForm] PostUploadDto dto)
{
    // 业务逻辑
}

2. 检查IIS自身的请求长度限制 #

部署在IIS上时，服务器层面的限制会覆盖.NET配置，需做以下调整：

• 通过IIS管理器设置：找到目标站点 → 点击「请求筛选」→ 「编辑功能设置」，将「最大允许内容长度(字节)」设为4294967295（对应int.MaxValue）。
• 手动修改web.config：在项目根目录的web.config中添加/修改以下节点：

<system.webServer>
  <security>
    <requestFiltering>
      <requestLimits maxAllowedContentLength="4294967295" />
    </requestFiltering>
  </security>
</system.webServer>
<!-- 若站点使用经典模式（极少情况），需添加以下节点 -->
<system.web>
  <httpRuntime maxRequestLength="4194304" /> <!-- 单位为KB，对应4GB -->
</system.web>

3. 排查React端fetch请求的潜在问题 #

Postman正常但React请求失败，大概率是请求构造错误：

• 不要手动设置Content-Type：fetch会自动根据FormData生成带边界标识的multipart/form-data头，手动设置会丢失边界信息，导致后端解析异常（误判为长度超限）。正确写法：

// 错误示例：手动指定Content-Type
fetch('/api/upload', {
  method: 'POST',
  headers: { 'Content-Type': 'multipart/form-data' },
  body: formData
});

// 正确示例：让浏览器自动处理Content-Type
fetch('/api/upload', {
  method: 'POST',
  body: formData
});

• 检查FormData构造逻辑：确认文件仅被追加一次，且字段名与后端PostUploadDto的属性名完全匹配（注意大小写，C#默认PascalCase，React若用camelCase需统一或配置序列化映射）。

4. 检查IIS应用池配置 #

• 确认应用池的托管管道模式为「集成」，.NET CLR版本为「无托管代码」（.NET 6独立部署要求），错误的托管模式会导致请求处理异常。
• 检查应用池的「队列长度」和「请求超时」设置，避免大文件请求因队列满或超时被截断。

5. 启用详细日志定位根因 #

在appsettings.json中开启调试级日志，查看具体错误触发点：

{
  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Http.Features.FormFeature": "Debug",
      "Microsoft.AspNetCore.Server.IIS": "Debug"
    }
  }
}

通过日志可明确是请求体、请求头还是其他环节触发的长度限制，针对性调整配置。

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