IIS请求筛选导致上传被拒绝时,如何定位限制项并调整配置?

发布人:A5数据发布时间:2026-10-23 14:42阅读量:69

上传接口返回“文件过大”或 HTTP 404,但小文件可以成功时,运维工程师通常先确认两件事:失败响应是否由 IIS 生成,以及被拒绝的是请求体、上传地址,还是应用程序自行校验的文件。若 IIS 日志中出现 404 13,应优先检查请求筛选的 maxAllowedContentLength;若是 404 7,则应检查被请求的 URL 扩展名规则,而不是直接调大上传容量。

调整配置前,要先取得同一次失败请求的状态码、子状态码和目标站点,并读取该站点或应用路径的有效配置。只改某份 web.config,却没有确认请求实际进入哪个站点、配置是否被继承或锁定,很容易出现“参数已经改了,上传仍然失败”。

先确认失败发生在哪一层

从一笔可重复的失败请求入手,记录请求时间、访问域名、上传接口路径、文件大小、客户端收到的状态码,以及同接口小文件是否成功。尽量使用测试账号和无敏感内容的测试文件;不要在生产环境反复提交可能产生业务记录的文件。

查看响应页面或响应头可以提供线索,但不能仅凭页面写着“IIS”就确定是请求筛选:前置 CDN、负载均衡、反向代理和应用程序都可能返回相似的错误。更可靠的做法是对照请求时间,确认该请求是否进入目标站点的 IIS 日志。

观察结果优先检查的位置判断要点
IIS 日志出现 404 13IIS 请求筛选的 requestLimits.maxAllowedContentLength请求体长度超过当前有效限制的可能性高
IIS 日志出现 404 7IIS 请求筛选的 fileExtensions检查上传接口的 URL 是否包含被拒绝的扩展名
IIS 日志出现 404 14 或 404 15URL 或查询字符串长度限制不应通过提高请求体限制处理
客户端报错,但目标站点没有对应日志站点匹配、前置接入层及其他入口请求可能尚未到达这个 IIS 站点
IIS 日志显示请求已进入应用,应用仍返回失败应用框架、上传组件及业务校验不能把应用层限制误判为 IIS 请求筛选

IIS 请求筛选中的 maxAllowedContentLength 限制的是整个 HTTP 请求体,不是文件本身的精确大小。使用 multipart/form-data 上传时,请求体还包含字段、边界和各部分的头信息。因此,一个恰好等于限制值的文件也可能被拒绝。

由外到内找到正在生效的规则

核对站点与失败日志

先在服务器上确认域名和路径对应的 IIS 站点。以下命令在安装了 IIS 的 Windows Server 上,以管理员身份打开“命令提示符”执行;命令只读取配置,不会修改服务。SiteName 和 Upload 均需替换为实际站点名、应用或虚拟路径。

由外到内找到正在生效的规则|核对站点与失败日志配图

%windir%\system32\inetsrv\appcmd.exe list site
%windir%\system32\inetsrv\appcmd.exe list config "SiteName/Upload" /section:system.webServer/security/requestFiltering

第一条命令用于核对站点名称、绑定和站点 ID;第二条用于查看指定路径的请求筛选有效配置。若上传接口位于站点根路径,可将第二条命令中的 "SiteName/Upload" 改为 "SiteName"。如果查询的路径并非 IIS 中的应用或虚拟目录,应先核对实际站点结构,不要根据相似的文件夹名称猜测配置作用范围。

IIS 访问日志的位置可在该站点的“日志记录”设置中确认。常见目录为 %SystemDrive%\inetpub\logs\LogFiles\W3SVC<站点ID>,但实际路径和日志字段可能已被修改。查看文件开头的 #Fields 行,再按字段顺序解读记录;IIS W3C 日志的时间通常使用 UTC,排查时要与客户端记录的时区对齐。

例如,下面是一段用于说明判断方式的日志片段,字段顺序以其中的 #Fields 为准:

#Fields: date time s-sitename cs-method cs-uri-stem sc-status sc-substatus sc-win32-status
2026-07-17 03:10:12 W3SVC2 POST /api/upload 404 13 0

如果这条记录与失败请求的时间、站点和接口均吻合,404.13 就为“请求体被 IIS 请求筛选拒绝”提供了直接线索。若没有对应记录,先检查是否找错站点或日志文件,再检查前置接入层;此时修改站点 web.config 没有可靠依据。

区分“上传的文件名”和“被访问的 URL”

扩展名限制容易造成误判。IIS 请求筛选的 fileExtensions 规则针对请求 URL:例如客户端请求 /upload/file.zip 时,URL 中的 .zip 可能匹配该规则。若客户端向 /api/upload 发送 multipart 请求,而 report.zip 只是表单中的文件名,不能仅凭这个文件名就断定是 IIS 的 URL 扩展名筛选拒绝了请求。

因此,遇到 404.7 时,应先检查实际请求 URL、重写规则和 fileExtensions 的有效配置,再判断是否需要对特定扩展名作站点级放行。遇到 404.14、404.15 时,则分别检查 URL、查询字符串是否过长;把 maxAllowedContentLength 调大不会解决这两类问题。

核对继承关系,而不只看一份文件

请求筛选设置可能来自服务器级配置、站点配置或应用目录的 web.config。IIS 管理器中的“请求筛选”以及“配置编辑器”可辅助查看所在级别和有效值;前面的 appcmd list config 则适合核对指定路径最终读取到的配置。

如果文件中的值与有效值不一致,先确认编辑的是正确站点和正确路径,再检查是否有下级配置覆盖。若修改后出现 HTTP 500.19,应根据页面中的配置错误代码核对 XML 语法、重复集合项或配置节锁定情况,而不是继续提高限制值。修改受锁定的配置节需要有相应管理权限;不要为了让单个上传接口生效,未经评估就放开整台服务器的配置委派。

当状态码仍不足以说明是哪一层拒绝时,可以在确认性能与日志空间余量后,短时间对目标站点、目标错误状态启用 IIS“失败请求跟踪”,查看命中的模块和规则。定位后关闭临时跟踪,并按运维要求处理可能包含请求信息的跟踪文件。

根据结果选择修复项

确认为 404.13:按业务上限调整请求体限制

maxAllowedContentLength 的单位是字节。例如计划接受约 95 MiB 的测试文件,可以先评估将请求体上限设为 100 MiB,即 104857600 字节;95 MiB 文件本身为 99614720 字节,剩余空间还需容纳 multipart 开销及其他表单字段。100 MiB 只是示例,不应直接作为所有业务的统一值。

变更前先确定业务允许的最大文件、请求中是否还有其他字段,以及前置接入层和应用程序各自的上限。然后备份将要编辑的 web.config,备份文件放在站点目录之外,并安排可观察、可回退的变更窗口。对已有配置文件,应将以下设置合并到原有层级,不要用示例覆盖整份文件:

<configuration>
  <system.webServer>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="104857600" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

此示例适用于允许在目标站点或应用的 web.config 中配置请求筛选的环境。如果原文件已有 requestFiltering 或 requestLimits,只调整现有节点的属性,避免重复节点导致配置错误。保存后重新执行 appcmd list config,确认目标路径的有效值确实变为预期值;再测试上传,不必把重启整台 IIS 服务器作为常规操作。变更 web.config 可能触发应用重新加载,应留意短时请求波动。

若应用是 ASP.NET Framework,还需单独核对适用路径的 system.web/httpRuntime 中 maxRequestLength,其单位是 KB,不能把 104857600 原样填入。例如 100 MiB 对应 102400 KiB,但业务若需要接收接近 100 MiB 的文件,还应考虑表单开销。ASP.NET Core 应检查其当前托管方式、表单解析和应用代码中的请求体限制;不要把 ASP.NET Framework 的配置项当作通用解法。无论使用哪种框架,只有在 IIS 已放行、请求确实进入应用后,应用层限制才是下一步重点。

确认为 404.7:核对 URL 扩展名策略

先从 IIS 日志中的 cs-uri-stem 和实际请求确认被拒绝的是哪条 URL,再读取该路径有效的 fileExtensions 设置。如果站点采用扩展名允许列表,应评估是否只允许业务必需的 URL 扩展名,并在相应作用范围内调整规则;如果是某个扩展名被显式拒绝,则需核对它来自哪一级配置,以及放行是否符合站点安全要求。

不要为了让一个上传请求通过,直接关闭请求筛选或把允许列表改为“允许所有”。若接口本应是无扩展名的 /api/upload,却出现扩展名拒绝,更值得先检查客户端请求地址或 URL 重写,而不是修改文件类型策略。调整后同时复测目标 URL 和原本应被拒绝的 URL,确认没有扩大无关资源的访问范围。

IIS 没有对应拒绝记录:检查其他上限

若失败请求未进入目标 IIS 站点,应核对 DNS、站点绑定、前置 CDN、负载均衡或反向代理的请求体限制和日志。若 IIS 已放行但应用返回错误,则结合应用日志检查框架配置、接口的文件大小校验、文件类型校验、临时目录及存储空间。

这些限制各自独立:把 IIS 上限改为 100 MiB,并不代表前置接入层或应用程序也会接受 100 MiB;同样,应用允许大文件,也无法替代 IIS 请求筛选的放行。应按失败发生的位置修改对应规则,避免一次性调大所有层的限制。

IIS 没有对应拒绝记录:检查其他上限配图

A5数据提供香港、美国、日本等地区的物理服务器,涵盖网站、业务后台与接口服务所需的不同CPU、内存和NVMe存储配置,也有面向大容量文件保存的存储型方案。对于承载上传接口及业务数据的服务器环境,可结合部署区域、程序负载和数据规模配置相应资源;多地区线路与存储选择,为不同访问范围和文件存储场景提供部署基础。

复测允许范围与拒绝边界

修复后使用同一站点、同一接口、相同认证方式进行复测。可以准备小文件、接近业务上限的文件,以及明确超过上限的文件;测试数据需确认不会产生不可接受的业务记录。以 100 MiB 请求体上限为例,95 MiB 文件通常可用于测试接近上限的场景,但是否通过仍取决于表单总开销和其他层的限制,不能只按文件大小判断。

复测允许范围与拒绝边界配图

在装有 curl.exe 的 Windows 测试机上,以下命令可发送一个 multipart 请求;路径、域名和文件应替换为获准使用的测试资源:

curl.exe -sS -o NUL -w "HTTP %{http_code}\n" -F "file=@C:\Temp\test95.bin" "https://upload.example.com/api/upload"

客户端得到 200 或 201 等业务预期响应后,还要核对应用是否实际收到并正确处理文件;仅看到一个成功状态码不足以证明上传内容完整。若仍得到 404,立即查看该次 IIS 日志的子状态码:仍为 404.13 时复核有效请求体上限及实际请求体大小;变为其他子状态码时按新证据处理;没有对应日志时回到入口层定位。

最后用超出业务上限的请求确认拒绝行为仍然存在,并观察变更后一段时间内的 404.13 数量、应用上传失败率、请求耗时和服务器磁盘使用情况。如果变更引入异常,恢复事先备份的 web.config,重新核对有效配置并复测原有的小文件上传。这样既能确认目标文件被允许,也能确认限制没有被无意中放宽到业务边界之外。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5350.html