IIS上传报404.13:检查请求大小限制

小附件能上传,稍大的文件却出现HTTP 404.13 - CONTENT_LENGTH_TOO_LARGE,应先查IIS请求筛选的内容长度上限。这里要核对的是一次上传实际发送了多少内容,以及哪个配置层级拒绝了它。

本文以Windows Server 2022、2025上的IIS 10为例。应用部分分别说明ASP.NET Framework 4.8/4.8.1与ASP.NET Core 10,其他框架和托管方式按实际版本核对。

先把报错对应到这一次上传

记录原域名、上传接口、时间、文件大小和响应状态。在目标站点的W3C日志中,按#Fields表头找到同一次请求,核对sc-status=404、sc-substatus=13;日志时间按UTC换算。不要用首页或另一条请求的结果代替。

只有普通404、413或应用自定义提示时,先确认实际子状态和错误来源。CDN、代理也可能提前拒绝上传;查不到记录应继续核对日志位置与入口。日志读取方法见IIS 404子状态排查,无需向公网开放详细错误页。

浏览器开发者工具中若能看到本次请求的Content-Length,可记录其数值作对照。只记录必要的长度、路径和时间,转交时隐藏令牌、Cookie及敏感文件名。

读取上传路径的有效配置

在已获授权的服务器上,以管理员身份打开64位Windows PowerShell,执行下面的只读查询。将BaoleSite/UploadApp/替换为IIS实际站点名与应用路径;根应用可用BaoleSite/,它不是磁盘目录:

& "$env:windir\System32\inetsrv\AppCmd.exe" list config "BaoleSite/UploadApp/" /section:system.webServer/security/requestFiltering /config:*

查找requestLimits中的maxAllowedContentLength。/config:*把继承值与默认值也显示出来;应用的web.config没有写这个属性,并不代表没有限制。上传接口若有更具体的路径配置,应继续查询对应的IIS配置路径。

该属性以字节计,默认值30000000约为28.6MiB,实际以上述查询为准。限制针对整次请求内容:多文件、表单字段和multipart分隔内容都会占空间,不能直接把单文件大小当作总请求大小。

确认业务需要后,只调整对应范围

先确定允许的单文件大小、每次文件数量和完整请求上限,评估并发上传的临时磁盘与内存需求。只有当前有效限制确实挡住正常业务时才调整。改前把涉及的配置备份到网站目录之外,记录原值和修改层级,并安排可接受应用重新加载的维护时间。

例如已经批准该应用整次请求内容最多32MiB,对应值为33554432。下面只是这个前提下的节点示意,不是所有网站的推荐额度:

<requestLimits maxAllowedContentLength="33554432" />

在对应应用允许修改的web.config中,将该属性合并到system.webServer/security/requestFiltering/requestLimits。已有节点时只修改属性,保留其他属性和子节点;不要重复添加节点或覆盖整份web.config。不要为单个应用改服务器全局额度。

若配置被上级锁定,交给该配置的管理员按实际应用范围处理,不全局解锁。保留文件类型、隐藏路径等筛选规则,也不要取消大小限制。保存后重新执行只读查询;出现配置错误时先恢复本次修改,再按IIS 500.19排查检查。

IIS放行之后,还要核对应用限制

IIS额度正确,应用仍可能拒绝请求。依据实际框架和新日志检查对应项,不把下面的参数全部一起调大:

实际应用 要核对的限制
ASP.NET Framework 4.8/4.8.1 system.web/httpRuntime的maxRequestLength单位是KB,不能照抄IIS的字节数;这项System.Web配置不适用于ASP.NET Core。
ASP.NET Core 10,IIS进程内托管 IISServerOptions.MaxRequestBodySize及接口的RequestSizeLimit涉及应用服务器的请求体额度,不能越过IIS请求筛选的限制。
ASP.NET Core 10,读取multipart表单 MultipartBodyLengthLimit控制每个multipart分段内容的长度,不能替代整个请求的上限或应用自己的单文件规则。

让应用维护者只调整确有需要的对应项。配置中的32MiB总额度也不意味着单个32MiB文件一定能上传,表单开销仍需计入。

验收时沿原入口上传合法的小文件和接近业务上限的测试文件,检查实际保存的大小、内容和业务记录;再用受控样例确认超出业务限额仍会被拒绝。会触发导入、转码等处理的上传,先在隔离环境验证,避免反复提交真实业务。

同时对照新日志和资源占用。404.13消失或返回200,都不能单独证明文件处理完成;仍失败时按新的错误继续定位,出现异常则恢复记录的原配置。