IIS 與 .NET Framework 安裝順序導致 ASPX 無法瀏覽的問題分析與解決

問題背景

近期協助他人部署一個小型網站，在本機測試時發現：HTML 靜態頁面可正常瀏覽，但 ASPX 動態頁面卻無法存取。這現象直接指向 IIS 對靜態與動態資源處理機制的差異，核心原因通常是 IIS 安裝順序早於 .NET Framework，導致 ASP.NET 執行環境未正確註冊至 IIS。

HTTP 請求在 IIS 中的處理流程

當 IIS 接收到 HTTP 請求，會根據檔案副檔名判斷處理方式：

• 靜態資源（.html、.htm、.js、.jpg、.png 等）：若 IIS 找不到對應的處理程式，且檔案不受伺服器端保護，則直接將檔案內容回傳給客戶端。
• 動態資源（.aspx、.ashx 等）：IIS 需尋找能處理該副檔名的 ISAPI 應用程式（Internet Server Application Programming Interface）。ISAPI 實際上是一個介面，負責將請求映射至對應的實際處理程式（如 aspnet_isapi.dll）。

若 .NET Framework 安裝在 IIS 之後，ASP.NET 所需的 ISAPI 對應關係不會自動建立，導致 ASPX 請求找不到處理程式，回傳 404 或直接顯示原始碼。

解決方案：重新註冊 ASP.NET

以管理員身分開啟「開發人員命令提示字元」（或 Visual Studio 命令提示字元），執行以下指令：

aspnet_regiis.exe -i

此指令會將 ASP.NET 版本註冊至 IIS，建立必要的 ISAPI 對應、應用程式集區與腳本對應。執行完成後，重新啟動 IIS（iisreset）即可恢復 ASPX 頁面正常瀏覽。

補充說明

• Windows 7/Server 2008 以上版本，若啟用「ASP.NET 4.5/4.6/4.7/4.8」Windows 功能，系統會自動處理註冊，通常不會遇到此問題。
• 若專案使用 .NET Core/5+，則不依賴 ASP.NET ISAPI，而是透過 ASP.NET Core Module (ANCM) 與 Kestrel 協作，安裝順序影響較小。

總結

IIS 必須先於 .NET Framework 安裝，或在安裝 .NET Framework 後執行 aspnet_regiis -i 完成註冊，才能確保動態頁面正確由 ASP.NET 執行引擎處理。部署前檢查安裝順序可避免此類問題。