一次“与我无关”的代码更新,弄坏了我网站的排查记录
- 2026-11-22 06:35:32
一、事情的前因后果
昨天下午下班前,QTS 网站访问一切正常。昨晚下班后,团队更新了一轮代码——业务上是 ERP 相关的,表面上和 QTS 完全无关。但这次更新修改了一个“公共文件”:站点根目录的 web.config。其中处理程序映射(handlers)里 aspx 处理器的 path 属性,由放行所有页面(*.aspx)收紧成了只放行 default.aspx(这是 ERP 单入口架构的典型写法)。
今早上班访问 localhost:7088/QTS/Login.aspx,直接报 HTTP 403。先解决了 NTFS 权限问题后,通过开启详细错误暴露出真实错误码是 404.3——“处理程序映射”出了问题。
整个因果链用一句话串起来就是:
昨晚代码更新 → 修改了共享的站点根 web.config → aspx 处理器 path 收紧为 **/default.aspx → QTS 自己的 web.config 里没有 handlers 节点,全盘继承了这份受限配置 → Login.aspx 匹配不到任何处理器 → 请求落到静态文件兜底 → 报 404.3。
这里有一个非常重要的认知纠偏:“跟我无关的更新”不等于“影响不到我”。那次更新改的是整个 IIS 站点共享的配置文件,影响面是站点下所有子应用,而不是“改了谁才影响谁”。这就是“别人的更新弄坏了我的网站”的真正机制。
二、根本原因
直接原因很明确:QTS 的有效 handlers 集合中,唯一的 aspx 处理器是 path=“**/default.aspx”,Login.aspx 匹配不上,于是报 404.3。
根本原因则是:昨晚的代码更新修改了父站点(站点根)的 web.config,收紧了 aspx 的放行规则。而 QTS 自身的 web.config 没有 handlers 节,按照 IIS 的配置继承机制,全盘接收了这份受限配置。
为什么站点下其他子应用都没坏、只有 QTS 坏了?因为 SYSA、EnpReport、hrkm、hrpms 这些老应用的 web.config 里都各自带着完整的 handlers 配置,覆盖了继承值,所以不受影响。QTS 是唯一一个“裸继承”父站配置的应用,于是成了唯一的受害者。
那为什么昨晚之前没事?因为更新之前父站点的 handlers 还没有收紧(或者 QTS 还没部署),继承链上传下来的还是完整的 *.aspx 放行。一夜之间,环境变了。
三、排查过程复盘(弯路也有价值)
第一步,看到表面错误码 403,没有子代码,只能列清单排查。教训:遇到 IIS 报错,第一件事就该开详细错误,在 web.config 里加上 httpErrors errorMode=“Detailed”,否则等于蒙着眼睛排查。
第二步,开启详细错误后暴露出 404.3,方向从“权限问题”切换到“处理程序映射问题”。这是整个排查中最关键的一步。
第三步,按 404.3 的标准流程操作:启用 Windows 功能里的 ASP.NET、执行 aspnet_regiis -i、iisreset。全部无效。走了弯路,但这些操作排除了服务器级问题。回头看,“独立端口的网站能正常访问”这个线索其实早就说明服务器级配置没坏——如果先做横向对比,这半小时可以省掉。
第四步,做应用池实验:让 QTS 换用主站点同一个应用程序池,仍然报错。加上池配置截图确认是 v4.0 加集成模式,应用池嫌疑彻底排除。
第五步,用 appcmd 对比父站点和 QTS 各自“最终生效”的 handlers 配置。关键发现:两层的输出一模一样,且 aspx 处理器的 path 是 **/default.aspx;同时用 appcmd list vdir 确认了 QTS 实际指向的物理路径,避免改错文件。这一步实锤了根因:问题不在应用池、不在服务器,而在配置继承链上。
第六步,修复:在 QTS 自己的 web.config 中补全 handlers 配置,父站点一字未动,网站恢复正常。
整个排查最有价值的经验是:“同一个服务器上,别人都正常就我不正常”,问题一定在应用级配置,而不是服务器级。先做横向对比,再查继承链,能少走很多弯路。
四、沉淀下来的排查 SOP
以后遇到 IIS 网站报错,按这个顺序走:
第一步,开启详细错误(httpErrors errorMode=“Detailed”),拿到精确的子代码。403.x 是权限验证类问题,404.3 是处理程序映射问题,两者是完全不同的问题域。
第二步,做横向对比:同一服务器上,其他站点、其他应用正常吗?如果都不正常,是服务器级问题,走 Windows 功能启用加 aspnet_regiis 加 iisreset 的路线;如果只有个别应用异常,就是应用级配置继承问题。
第三步,用 appcmd 对比父站点与子应用的“有效配置”,确认子应用到底拿到了什么。输出合并继承后的最终结果,比人肉翻配置文件可靠得多。
第四步,对症修复。如果是父站点收紧了规则导致子应用裸继承,就在子应用自己的 web.config 里用 clear 加显式重加全套处理器;如果是子应用自己的配置里 clear 或 remove 清掉了处理器,就补回来。
第五步,修复后追溯变更来源:翻 C:\inetpub\history\ 下的配置快照,或查 IIS-Configuration 操作日志(Event ID 29),搞清楚“谁在什么时候改了什么”。
五、常用命令备忘
:: 看某应用最终生效的 handlers(本次破案的关键命令)
appcmd list config "站点名/子应用名" /section:system.webServer/handlers
:: 确认各应用实际指向的物理路径(避免改错文件)
appcmd list vdir
:: 看所有应用程序池的关键配置
appcmd list apppool /text:*
:: 解锁 handlers 节(遇到 500.19 节被锁定时用)
appcmd unlock config -section:system.webServer/handlers
:: IIS 配置备份与还原(改动配置前必做)
C:\Windows\System32\inetsrv\appcmd.exe add backup "改动前"
C:\Windows\System32\inetsrv\appcmd.exe restore backup "改动前"
:: 追溯配置变更(取证用)
dir C:\inetpub\history\
Get-WinEvent -LogName "Microsoft-IIS-Configuration/Operational"
六、修复配置存档
修改的文件是 QTS 的 web.config(D:\Program Files (x86)\report\QMS\QTS\Web\web.config),在 configuration 节点下加入:
<handlers><clear /><addname="PageHandlerFactory-Integrated-4.0"path="*.aspx"verb="GET,HEAD,POST,DEBUG"type="System.Web.UI.PageHandlerFactory"preCondition="integratedMode,runtimeVersionv4.0" /><addname="SimpleHandlerFactory-Integrated-4.0"path="*.ashx"verb="GET,HEAD,POST,DEBUG"type="System.Web.UI.SimpleHandlerFactory"preCondition="integratedMode,runtimeVersionv4.0" /><addname="AssemblyResourceLoader-Integrated-4.0"path="WebResource.axd"verb="GET,DEBUG"type="System.Web.Handlers.AssemblyResourceLoader"preCondition="integratedMode,runtimeVersionv4.0" /><addname="StaticFile"path="*"verb="GET,HEAD,POST"modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"resourceType="Either"requireAccess="Read" /></handlers>
两点留档注意:clear 切断继承之后必须补全所有必需的处理器,缺一个就是一个新坑;StaticFile 兜底必须放在最后。另外如果项目以后用到 PUT、DELETE 这类请求方法,要把 StaticFile 的 verb 放宽为 *,否则会报 405。
保存后 IIS 会自动重载配置,一般不需要 iisreset,直接刷新浏览器验证即可。
七、经验教训(团队层面)
第一,共享 IIS 站点下的 web.config 是“公共设施”。站点根的 web.config 影响所有子应用。这次的教训是:更新 ERP 时顺手改了站点根 web.config,波及了看似无关的 QTS。今后凡涉及站点根 web.config 的变更,应该知会所有子应用的负责人。
第二,子应用的 web.config 应该“自带完整 handlers”。本站点是单入口架构,站点根只放行 default.aspx,这是既定设计;新部署的子应用必须在自身 web.config 里自带 handlers 覆盖继承,否则上线即 404.3。这条应该写进团队的部署文档。
第三,改配置前先备份、改完留记录。appcmd add backup 一条命令的事,能省一整天的排查。
八、防复发待办
一,和昨晚更新的同事对齐:确认站点根 web.config 收紧 aspx 放行是有意为之(ERP 安全设计)还是误改;若是误改可考虑恢复,QTS 的补丁则作为双保险保留。
二,取证留痕:翻 C:\inetpub\history\ 快照和 IIS-Configuration 日志,锁定昨晚变更的具体时间点和内容,作为团队规范讨论的依据。
三,体检其他子应用:逐个确认 SYSA、EnpReport、hrkm、hrpms、QMSQTS 的 web.config 都自带完整的 handlers 节。
四,写入部署文档:在 publish/IIS部署操作 目录下的文档中新增一条——本站点为单入口设计,子应用必须在自身 web.config 中自带完整 handlers 配置,并附上这次的修复片段。
五,开启配置审计:把 configHistory 的 maxHistories 调大到 100,开启文件审核,下次“谁改的、改了什么”十分钟就能出答案。
六,建立变更通知机制:约定动站点根 web.config 或 applicationHost.config 之前,先在群里知会一声。