部署 ASP.NET/ASP 應用到 IIS 時遭遇 500.19,錯誤頁面僅顯示「配置數據無效」,實際原因多樣。本文歸納三大高發場景:**ASP.NET 版本註冊缺失、IIS 7+ 權限缺失、詳細錯誤被隱藏**,提供逐步修復命令與截圖指引,並給出通用排查清單。
癥狀:瀏覽 `.asmx`/`.aspx`/`.svc` 直接拋 500.19,錯誤碼 `0x80070021` 或 `0x8007000d`。
修復:重新註冊 ASP.NET 4.0/2.0
REM 32 位系統 / 64 位系統運行 32 位應用池
cd /d %windir%\Microsoft.NET\Framework\v4.0.30319
aspnet_regiis.exe -i -enable
REM 64 位系統運行 64 位應用池
cd /d %windir%\Microsoft.NET\Framework64\v4.0.30319
aspnet_regiis.exe -i -enable
REM IIS 7+ 還需執行 (管理員 PowerShell)
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET45 -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-NetFxExtensibility45 -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIExtensions -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIFilter -All
註:IIS 10/Windows 10+ 已棄用 `aspnet_regiis`,必須用 DISM/PowerShell 啟用 Windows 功能。
癥狀:ASP 應用連 Access 資料庫報錯,實際是 `NetworkService` 身份無法寫入 `C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp`。
修復:授權 Authenticated Users 完全控制 Temp 目錄
癥狀:瀏覽器僅顯示通用腳本錯誤 `An error occurred on the server when processing the URL...`,無具體行號/異常類型。
修復:開啟詳細錯誤傳送至瀏覽器
| 檢查點 | 工具/命令 | 常見問題 |
|---|---|---|
| web.config 格式/節點錯誤 | XML 格式驗證器、IIS 管理員「配置編輯器」 | 重複 section、大小寫錯誤、缺少 section 宣告、鎖定屬性衝突 |
| 應用程式池 .NET 版本/管道模式不匹配 | IIS 管理員 → 應用程式池 → 基本設置 | 4.0 整合模式 vs 2.0 經典模式、32 位應用程式啟用不一致 |
| 模組/處理常式映射衝突/缺失 | web.config ` | UrlRewrite/Compression/StaticFile 模組重複/順序錯誤 |
| 權限:應用程式池身份無法讀取物理路徑 | icacls / 文件夾屬性 → 安全性 | 需授予 `IIS AppPool\ |
| 依賴組件未安裝 (VC++ Runtime, URL Rewrite, ARR 等) | 程式和功能 / 獨立安裝包 | 缺少 Visual C++ 2015-2022 Redistributable |
| 配置鎖定 (lockAttributes/lockItem) 導致無法覆寫 | `appcmd list config /commit:apphost /section:...` | 在 applicationHost.config 解鎖或移除鎖定 |
最佳實踐: