在ASP.NET应用程序中，默认的文件上传大小限制为4MB（4096 KB），这是一个安全措施，防止恶意用户通过上传超大文件耗尽服务器资源（如内存、磁盘空间或处理能力），从而导致拒绝服务（DoS）攻击,解决这一限制的核心在于修改相关的配置文件或代码配置项。
突破4MB限制的主要方法
解决此限制通常涉及修改两个关键的配置设置：maxRequestLength 和 maxAllowedContentLength，它们分别作用于ASP.NET运行时和IIS（或IIS Express）层面。
-
修改
web.config文件 (ASP.NET 运行时限制)
这是最核心的步骤，在应用程序的根目录下找到或创建web.config文件，在<system.web>节点下，找到或添加<httpRuntime>元素，并设置其maxRequestLength属性。<configuration> <system.web> <!-- 设置最大请求长度，单位是KB，100MB = 102400 KB --> <httpRuntime maxRequestLength="102400" /> ... </system.web> </configuration>maxRequestLength: 这个属性指定了ASP.NET运行时允许的最大请求大小（以KB为单位），默认值是4096 (4MB)，将其设置为所需的值（如102400代表100MB），这个值限制了ASP.NET处理程序能接收的请求总大小（包括文件、表单字段、Header等）。
-
修改
web.config文件 (IIS / IIS Express 请求筛选限制)
对于运行在IIS 7.0及以上版本或IIS Express的应用程序，仅仅设置maxRequestLength通常还不够，IIS的请求筛选模块 (requestFiltering) 在请求到达ASP.NET之前就实施了限制，需要在<system.webServer>节点下配置它。<configuration> <system.webServer> <security> <requestFiltering> <!-- 设置允许的最大内容长度，单位是字节，100MB = 104857600 字节 --> <requestLimits maxAllowedContentLength="104857600" /> </requestFiltering> </security> ... </system.webServer> </configuration>maxAllowedContentLength: 这个属性指定了IIS允许的最大请求内容长度（以字节为单位），默认值大约是30000000字节（~28.6MB），但为了确保覆盖你的需求，显式设置它非常重要，104857600字节等于100MB，这个限制作用于请求的正文（Body）部分。
关键点与注意事项
- 必须同时设置两者： 对于在IIS/IIS Express上运行的现代ASP.NET应用程序（Web Forms, MVC, Core 之前的版本），
maxRequestLength(ASP.NET层) 和maxAllowedContentLength(IIS层) 通常都需要配置才能完全解除4MB限制，如果只设置其中一个,请求仍可能被另一个层面拦截。 - 单位不同： 务必注意单位的区别！
maxRequestLength是 KB，而maxAllowedContentLength是 字节，计算错误会导致配置无效（设置maxAllowedContentLength="102400"实际上只允许约100KB）。 - 位置： 确保
<httpRuntime>在<system.web>内，<requestLimits>在<system.webServer><security><requestFiltering>内。 - IIS 版本： 对于IIS 6.0（已较少使用），主要配置是
<httpRuntime maxRequestLength="..." />，因为IIS 6.0的请求处理模型不同。 - ASP.NET Core： 本文主要针对传统的ASP.NET（.NET Framework）。ASP.NET Core 的配置方式完全不同，它使用
Kestrel服务器选项或在中间件中配置限制（如UseKestrel配置Limits.MaxRequestBodySize或使用RequestSizeLimitAttribute）。 - 安全警告： 切勿盲目设置一个非常大的值（如
maxRequestLength="2097151"即2GB最大值），这会使你的服务器面临DoS攻击风险，务必根据应用程序的实际需求设置一个合理的上限，评估你的服务器硬件（内存、磁盘I/O、CPU）能否承受并发上传多个大文件的压力。 - 执行超时： 上传大文件需要更长时间，确保
<httpRuntime>的executionTimeout属性（单位秒）也设置得足够大，以防止上传过程中请求超时，默认是110秒。<httpRuntime maxRequestLength="102400" executionTimeout="3600" />(1小时)。 - 内存使用： 默认情况下，ASP.NET会尝试将整个请求（包括上传的文件）缓冲到服务器内存中，上传非常大的文件（如数百MB或GB级）时，这会导致极高的内存消耗甚至内存溢出,这是4MB限制存在的另一个重要原因。
处理超大文件的上传（优化与进阶）
对于远超100MB的文件上传，仅仅修改配置可能不够,还需要优化上传处理逻辑以避免内存问题：
-
流式处理： 不要依赖
Request.Files或模型绑定（它们会尝试将整个文件读入内存），使用Request.GetBufferlessInputStream()或Request.InputStream来获取原始请求流，然后分块读取数据流并直接写入磁盘文件,这显著减少内存占用。// 示例片段 (Web Forms / MVC) Stream requestStream = Request.GetBufferlessInputStream(); // 或 Request.InputStream using (FileStream fileStream = File.Create(savePath)) { byte[] buffer = new byte[4096]; // 4KB缓冲区 int bytesRead; while ((bytesRead = requestStream.Read(buffer, 0, buffer.Length)) > 0) { fileStream.Write(buffer, 0, bytesRead); // 可选：更新进度 } } -
分块上传： 在客户端（JavaScript）将大文件分割成较小的块，依次上传，服务器端接收这些块并逐个写入目标文件，最后合并，这提高了可靠性（断点续传）、便于显示进度条，并分散了服务器端的瞬时压力，可以利用现成的JavaScript库（如Resumable.js, Flow.js）或实现自定义逻辑。
-
调整缓冲： 在
web.config的<httpRuntime>中设置requestValidationMode="2.0"(如果尚未设置) 并启用enableVersionHeader="false"(安全考虑)，更重要的是，对于超大文件，流式处理（方法1）是避免缓冲的关键。
-
IIS 临时文件： 即使使用了流式处理，IIS可能会在将请求传递给ASP.NET之前将请求体缓冲到临时磁盘文件（如果超过某个阈值），这由IIS管理，通常比内存缓冲要好，但要注意磁盘I/O性能，位置通常在
%SystemDrive%inetpubtempIIS Temporary Compressed Files或类似路径。
解除ASP.NET默认的4MB文件上传限制，核心在于正确配置 web.config 文件中的两个关键参数：<system.web> 下的 <httpRuntime maxRequestLength="..."> (单位KB) 和 <system.webServer> 下的 <requestLimits maxAllowedContentLength="..."> (单位字节)，务必考虑服务器安全，设置合理的上限值并监控资源使用，对于超大文件（如数百MB以上），强烈建议采用流式处理或分块上传技术,以优化内存使用和提升用户体验。
你在实际项目中遇到过怎样的文件上传需求？是成功解决了超大文件上传的挑战，还是遇到了其他有趣的配置问题？欢迎在评论区分享你的经验和遇到的“坑”！
原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/20569.html
评论列表（2条）
这个教程超实用！对ASP.NET开发来说，突破4M限制能提升用户体验，尤其用户量大时文件上传需求激增。不过规模大了后要警惕资源耗尽的风险，安全平衡才是关键。
这篇文章超实用！作为技术博主，分享这种教程确实能提升个人品牌影响力，但安全第一，修改时记得平衡风险哦。