You need to enable JavaScript to run this app. ASP.NET Core 如何正确捕获处理HTTP 413 Payload Too Large错误
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET Core 如何正确捕获处理HTTP 413 Payload Too Large错误

根因说明
  • 413 Payload Too Large 错误由IIS请求管道在请求进入ASP.NET Core应用前直接拦截触发,不会流经应用内的中间件管道,因此Startup中配置的app.UseStatusCodePagesWithReExecute()无法捕获该状态码。
  • 此前配置导致其他状态码自定义处理失效的核心原因:web.config中设置的existingResponse="Replace"会强制IIS替换所有状态码的应用响应,把原本由应用中间件自定义生成的404、500等错误响应直接替换为IIS的自定义错误逻辑,直接打断了应用原有的错误处理流程。
解决步骤

1. 修正web.config配置

仅对413状态码做定向接管,其余状态码完全透传应用本身的响应内容,配置示例如下:

<system.webServer>
  <!-- 仅定向处理413错误,不干扰应用内的错误处理 -->
  <httpErrors errorMode="Custom" existingResponse="PassThrough">
    <remove statusCode="413" subStatusCode="-1" />
    <error 
      statusCode="413" 
      subStatusCode="-1" 
      path="/StatusCodeError/413" 
      responseMode="ExecuteURL" 
    />
  </httpErrors>
  <!-- 匹配应用允许的最大请求体大小,单位为字节 -->
  <aspNetCore>
    <requestLimits maxAllowedContentLength="52428800" />
  </aspNetCore>
</system.webServer>

关键配置说明:

  • existingResponse="PassThrough":核心修复项,当应用本身已生成对应状态码的响应时,IIS直接透传响应内容,不做强制替换,保障原有应用内的自定义错误处理逻辑不受影响。
  • responseMode="ExecuteURL":采用服务器内部路由执行跳转,不会像Redirect那样产生302跳转改变浏览器地址栏,避免无意义的跳转开销。
  • 仅针对413状态码配置处理规则,不对其他状态码做全局拦截。

2. 保留原有应用错误处理逻辑

Startup.cs中配置的app.UseStatusCodePagesWithReExecute("/StatusCodeError/{0}")无需修改,可正常处理应用管道内触发的404、401等状态码,和IIS层面接管的413错误完全互不干扰。

注意:maxAllowedContentLength的取值需要和应用本身的请求大小限制保持一致,避免IIS拦截阈值与应用处理阈值不匹配,导致出现非预期的错误触发时机。

内容的提问来源于stack exchange,提问作者user5255727

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 19:45:02