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
相关产品推荐
相关产品推荐

