在 IIS 7 中啟用 URL Rewrite 將 *.html 交由 ASP.NET 處理後,真實存在的靜態 .html 檔案無法存取,錯誤訊息:
無法執行 URL。
System.Web.HttpException: Failed to Execute URL
ASP.NET 管線接管 *.html 後,對於不符合重寫規則的真實靜態檔案,ASP.NET 不知道如何處理(缺乏對應的 IHttpHandler),導致請求未被任何模組處理而拋出 500 錯誤。
在 web.config 的 <system.webServer> → <handlers> 區段加入:
<configuration>
<system.webServer>
<handlers>
<add name="StaticHtml" path="*.html" verb="*" type="System.Web.StaticFileHandler" resourceType="File" requireAccess="Read" />
</handlers>
</system.webServer>
</configuration>
name:唯一識別名稱 (如 StaticHtml)。path:*.html 比對所有 .html 請求。verb:* 允許所有 HTTP 動詞。type:System.Web.StaticFileHandler — 內建靜態檔案處理器,直接讀取檔案內容回傳,不經過 ASP.NET 頁面生命週期。resourceType="File":僅處理實體存在的檔案。requireAccess="Read":需具備讀取權限。web.config,IIS 自動重載配置。test.html → 正常顯示內容。article-123.html → 正確對應至 article.aspx?id=123 執行動態頁面。<system.web> 區段 (IIS 6 相容模式)<system.web>
<httpHandlers>
<add verb="*" path="*.html" type="System.Web.StaticFileHandler" />
</httpHandlers>
</system.web>
但在 IIS 7+ 整合管線模式下,以 <system.webServer><handlers> 為準。
runAllManagedModulesForAllRequests="false",僅對必要副檔名對應 Managed Handler。.aspx 或 .cshtml 副檔名,避免衝突。