萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

IIS 7 URL Rewrite 導致靜態 HTML 無法存取的解決方案

問題現象

在 IIS 7 中啟用 URL Rewrite 將 *.html 交由 ASP.NET 處理後,真實存在的靜態 .html 檔案無法存取,錯誤訊息:

無法執行 URL。
System.Web.HttpException: Failed to Execute URL

根本原因

ASP.NET 管線接管 *.html 後,對於不符合重寫規則的真實靜態檔案,ASP.NET 不知道如何處理(缺乏對應的 IHttpHandler),導致請求未被任何模組處理而拋出 500 錯誤。

解決方法:註冊 StaticFileHandler 處理 .html

在 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":需具備讀取權限。

驗證步驟

  1. 儲存 web.config,IIS 自動重載配置。
  2. 瀏覽器存取現有 test.html → 正常顯示內容。
  3. 存取符合重寫規則的偽靜態 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。
  • 靜態資源 (CSS/JS/圖片/HTML) 盡量由 IIS 靜態檔案模組直接服務,效能最佳。
  • 若大量靜態 HTML 需重寫,考慮改用 .aspx 或 .cshtml 副檔名,避免衝突。
copyright © 萬盛學電腦網 all rights reserved