在ASP.NET应用程序中，通过Web.config的system.web节点下的httpRuntime配置可以调整请求处理的相关参数，其中上传文件大小限制是开发者经常需要修改的配置项，该配置直接影响用户上传文件的最大允许大小。
httpRuntime核心配置参数说明
httpRuntime节点包含多个属性，和上传文件大小限制直接相关的参数主要有以下两个：
- maxRequestLength：表示ASP.NET支持的最大请求大小，单位是KB，默认值为4096，也就是4MB。该值限制了整个HTTP请求的总大小，包含上传的文件内容、表单其他字段等所有请求数据。
- executionTimeout：表示请求执行的最大超时时间，单位是秒，默认值为110秒。上传大文件时如果网络速度较慢，可能需要适当调大该值，避免上传未完成就被终止。
具体配置示例
如果希望将上传文件的最大大小限制调整为20MB，同时调整超时时间为300秒，可以在Web.config的system.web节点中添加如下配置：
<configuration>
<system.web>
<!-- maxRequestLength单位为KB，20MB等于20*1024=20480KB -->
<httpRuntime maxRequestLength="20480" executionTimeout="300" />
</system.web>
</configuration>
IIS版本适配注意事项
如果是部署在IIS7及以上版本的环境中，仅修改system.web下的httpRuntime配置可能不够，还需要在system.webServer节点中添加请求过滤配置，否则IIS层面会先拦截超过默认大小（30MB）的请求：
<configuration>
<system.webServer>
<security>
<requestFiltering>
<!-- maxAllowedContentLength单位为字节，20MB等于20*1024*1024=20971520字节 -->
<requestLimits maxAllowedContentLength="20971520" />
</requestFiltering>
</security>
</system.webServer>
</configuration>
常见问题排查
配置完成后如果上传仍然失败，可以从以下几个方向排查：
- 检查maxRequestLength和maxAllowedContentLength的单位是否换算正确，前者是KB，后者是字节，容易混淆。
- 确认配置是否放在了正确的节点下，system.web对应经典管道模式，system.webServer对应集成管道模式，如果应用池使用集成模式，两个配置都需要设置。
- 检查服务器是否有其他全局配置覆盖了当前应用的设置，比如IIS的全局请求过滤规则。
配置验证方法
可以通过编写一个简单的上传页面来验证配置是否生效，上传一个略大于设置限制的文件，观察是否返回请求大小超出限制的错误，如果返回则说明配置生效。以下是简单的上传测试代码：
<%@ Page Language="C#" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>上传测试</title>
</head>
<body>
<form id="form1" runat="server" enctype="multipart/form-data">
<div>
<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="上传" OnClick="btnUpload_Click" />
</div>
</form>
</body>
</html>
protected void btnUpload_Click(object sender, EventArgs e)
{
if (FileUpload1.HasFile)
{
// 保存上传的文件，路径根据实际需求调整
string savePath = Server.MapPath("~/Uploads/") + FileUpload1.FileName;
FileUpload1.SaveAs(savePath);
Response.Write("上传成功");
}
}
httpRuntimeWeb.configsystem.web上传文件大小限制修改时间：2026-06-16 08:06:10