萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

IIS 7 URL Rewrite 導致靜態 HTML 無法存取?修正 StaticFileHandler 設定

在 IIS 7 中啟用 URL Rewrite 將 .html 交由 ASP.NET 處理後,原本存在的靜態 HTML 檔案可能無法存取,出現「未能執行 URL」錯誤。原因在於 ASP.NET 管線不再自動處理靜態檔案,需手動註冊 StaticFileHandler。

錯誤現象

系統錯誤: System.Web.HttpException: 未能執行 URL。

解決方法:修改 web.config

在 <system.webServer> 區段下的 <handlers>(IIS 7+ 整合模式)或 <httpHandlers>(經典模式)加入:

整合模式(建議)

<system.webServer>
  <handlers>
    <add name="StaticFileHandler-HTML" 
         path="*.html" 
         verb="*" 
         type="System.Web.StaticFileHandler" 
         preCondition="integratedMode" />
  </handlers>
</system.webServer>

經典模式

<system.web>
  <httpHandlers>
    <add verb="*" path="*.html" type="System.Web.StaticFileHandler" />
  </httpHandlers>
</system.web>

原理說明

  • URL Rewrite 將 *.html 對應至 ASP.NET 管線。
  • ASP.NET 預設不處理靜態檔案,需明確註冊 StaticFileHandler。
  • 註冊後,符合重寫規則的走動態處理,不符合的靜態 HTML 由 StaticFileHandler 直接回傳。

驗證方式

  1. 儲存 web.config。
  2. 瀏覽器重新整理原本無法存取的 .html 頁面。
  3. 確認回應標頭 Content-Type: text/html 且內容正確。

此設定相容共存:偽靜態 .html 走 MVC/WebForms,真實靜態 .html 由 IIS 直接服務,互不干擾。

copyright © 萬盛學電腦網 all rights reserved