ASP.NET Core大文件上传配置与优化指南

1. 问题背景与核心痛点

在ASP.NET Core开发中，文件上传和大型数据提交是常见的业务场景。但系统默认的请求大小限制往往成为开发者的"隐形杀手"。最近我在处理一个医疗影像上传项目时就踩了这个坑——当用户尝试上传CT扫描的DICOM文件（平均300MB）时，系统直接返回413 Payload Too Large错误。

经过排查发现，ASP.NET Core默认存在三层限制：

1. Kestrel服务器默认最大请求体：28.6MB
2. 表单数据默认最大长度：128MB
3. IIS托管时额外限制：28.6MB

这些限制分散在不同层级，需要开发者全面了解才能彻底解决问题。下面我将结合实战经验，详细解析各层级的配置方法和底层原理。

2. 核心配置方案详解

2.1 Kestrel服务器请求体限制

作为ASP.NET Core的默认跨平台服务器，Kestrel的限制是最先触发的门槛。其默认配置在Program.cs中修改：

csharp复制builder.WebHost.ConfigureKestrel(serverOptions => {
    // 设置为1GB，单位字节
    serverOptions.Limits.MaxRequestBodySize = 1073741824; 
});

重要提示：此设置对反向代理场景（如Nginx）同样有效，因为请求会直接传递给Kestrel处理。但需要注意物理服务器的内存容量，过大的限制可能导致内存溢出。

2.2 表单数据长度限制

当使用multipart/form-data格式上传文件时，需要单独配置表单限制：

csharp复制builder.Services.Configure<FormOptions>(options => {
    options.MultipartBodyLengthLimit = 1073741824; // 1GB
    options.ValueLengthLimit = int.MaxValue;       // 单个字段长度限制
    options.MultipartHeadersLengthLimit = int.MaxValue; // 头信息限制
});

这三个参数需要配合使用：

• `