大文件上传触发请求长度限制时返回HTML而非500错误页面问题

我帮你梳理下这个问题的核心原因，以及对应的解决步骤：

问题根源 #

你遇到的情况本质是上传大文件触发的请求长度超限错误，在ASP.NET的customErrors模块处理之前就被IIS拦截了，而且你的httpErrors配置用了错误的响应模式，导致直接返回静态HTML文件且状态码为200，而非预期的错误状态码。

另外要注意：上传文件超出限制时，IIS触发的是413 Request Entity Too Large错误，不是你配置的500，这也是你的500错误规则没生效的关键原因。

解决方案分三步走： #

1. 处理错误状态码的匹配与响应模式

在system.webServer/httpErrors里添加对413错误的捕获，同时把responseMode从File改成ExecuteURL——这个模式会让IIS执行指定URL而非直接返回静态文件，同时保留原始错误状态码：

<system.webServer>
  <httpErrors errorMode="Custom" existingResponse="Replace">
    <remove statusCode="404" />
    <error statusCode="404" path="/error.html" responseMode="ExecuteURL" />
    <remove statusCode="500" />
    <error statusCode="500" path="/error.html" responseMode="ExecuteURL" />
    <!-- 添加413错误的处理，这才是大文件上传触发的错误码 -->
    <remove statusCode="413" />
    <error statusCode="413" path="/error.html" responseMode="ExecuteURL" />
  </httpErrors>
  <!-- 其他webServer配置 -->
</system.webServer>

existingResponse="Replace"的作用是确保自定义错误完全覆盖IIS默认的错误响应，避免冲突。

2. 确认ASP.NET的customErrors配置有效性

你的customErrors配置本身没问题，只需确认路径正确即可：

<system.web>
  <customErrors mode="On" redirectMode="ResponseRewrite" defaultRedirect="~/error.html">
    <error statusCode="404" redirect="~/error.html" />
    <error statusCode="500" redirect="~/error.html" />
  </customErrors>
  <!-- 如果需要允许更大文件上传，添加下面的配置（单位KB） -->
  <httpRuntime maxRequestLength="1048576" /> <!-- 示例：允许1GB的文件上传 -->
</system.web>

3. （可选）调整IIS的请求长度限制

如果你确实需要允许用户上传更大的文件，还要在system.webServer里配置requestFiltering（单位为字节，需和上面的maxRequestLength数值对应）：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 1GB = 1*1024*1024*1024 = 1073741824字节 -->
      <requestLimits maxAllowedContentLength="1073741824" />
    </requestFiltering>
  </security>
  <!-- 其他配置 -->
</system.webServer>

注意：maxAllowedContentLength（字节）和maxRequestLength（KB）的数值要匹配，否则会出现其中一个限制先触发的情况。

测试验证 #

现在再尝试上传超过限制的大文件，应该会返回渲染后的error.html页面，且响应状态码为413（若未调整限制）；如果是其他500错误场景，也会正确返回自定义页面和500状态码。

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