ASP.NET 應用程式在 IIS 上無法運行,是開發者最常遇到的部署噩夢。本文彙整實務上 99% 有效的四大修復方案,涵蓋安裝順序錯誤、腳本對應遺失、ASPNET 帳號密碼同步、網域控制器特殊配置,附完整指令與操作步驟,快速恢復服務。
正確順序:先裝 IIS → 再裝 .NET Framework / Visual Studio
若順序顛倒、或 IIS 重裝、升級 .NET 版本,必須重新註冊 ASP.NET ISAPI 對應:
cd C:\WINDOWS\Microsoft.NET\Framework\v1.0.3705
aspnet_regiis.exe -i
此指令會:註冊 `.aspx`、`.asmx` 等副檔名對應至 `aspnet_isapi.dll`、安裝用戶端驗證腳本庫、設定預設應用程式池。
<processModel
userName="Machine"
password="AutoGenerate" />
<processModel
userName="ASPNET"
password="YourNewPassword" />
若上述無效,嘗試:
DC 上 `ASPNET` 本地帳號無法正常運作,需建立網域帳號:
<processModel
userName="DomainName\ASPUSER"
password="ASPUSER_Password" />
最後 `iisreset` 重啟服務。
| 錯誤 | 可能原因 | 對應方案 |
|---|---|---|
| HTTP 404 .aspx | 腳本對應遺失 | 方案一 `aspnet_regiis -i` |
| HTTP 500 伺服器錯誤 | ASPNET 密碼不同步 | 方案二 重設密碼 + Machine.config |
| 存取被拒絕 | 目錄權限不足 | 檢查 ASPNET/ASPUSER NTFS 權限 |
| 無法載入 aspnet_isapi.dll | .NET Framework 損毀 | 修復/重裝 .NET Framework |
掌握這套「診斷 → 修復 → 驗證」標準流程,讓 IIS 部署問題不再是阻礙,而是可預測、可控制的常規操作。