Plesk Obsidian 18 開啟 ASP.NET 與 web.config 詳細錯誤訊息完整教學

在 Windows 虛擬主機環境中，常見的網站程式技術包含 ASP.NET 與 ASP.NET Core。
當網站發生錯誤時，畫面上往往僅顯示簡單的錯誤訊息，
實際錯誤原因並不會直接呈現。

本文將說明如何在 Plesk Obsidian 18 控制台 中，
自行開啟 ASP.NET 的錯誤顯示設定，
以及透過 web.config 來查看更完整的錯誤記錄，
協助使用者或程式人員快速排查問題。

Windows 虛擬主機與 ASP.NET 錯誤說明

Windows 虛擬主機主要用於執行 ASP.NET 或 ASP.NET Core 網站程式。
當網站發生錯誤時，預設多半只會顯示簡單的 HTTP Error 頁面，
並不會直接顯示實際錯誤原因。

在進行錯誤排查前，建議先確認目前網站是使用 ASP.NET（.NET Framework）
或 ASP.NET Core，不同技術在錯誤顯示與記錄方式上會略有差異。

ASP.NET 與 ASP.NET Core 錯誤顯示差異說明

在實務上，ASP.NET（.NET Framework）與 ASP.NET Core 在錯誤顯示機制上有明顯差異，
若未先區分清楚，可能會導致設定正確卻仍無法看到錯誤內容。

• ASP.NET（.NET Framework）：主要透過 Custom Errors 與 IIS 錯誤頁控制顯示內容。
• ASP.NET Core：錯誤多半記錄於 stdout log 或系統事件記錄，畫面通常僅顯示 HTTP Error。

因此，若網站為 ASP.NET Core 專案，即使已於 Plesk 中調整 ASP.NET 的 Custom Errors 設定，
實際錯誤仍需搭配 web.config 與錯誤記錄檔來判斷。

Windows 虛擬主機 Plesk 控制台開啟 ASP.NET 自訂錯誤

若您的 Windows 虛擬主機是使用 Plesk Obsidian 18 控制台，
且網站程式為 ASP.NET（非 ASP.NET Core），
可透過控制台內建的 ASP.NET 設定來調整錯誤顯示方式。

在 ASP.NET 設定頁面中，可找到 Custom Errors mode（自訂錯誤模式），
此選項用於控制錯誤顯示內容。

• On：顯示自訂錯誤頁
• Off：顯示完整錯誤訊息
• RemoteOnly：本機顯示詳細錯誤，遠端顯示自訂錯誤

HTTP Error 500.30 – ASP.NET Core app failed to start

當網站使用 ASP.NET Core，
且瀏覽網站時出現 HTTP Error 500.30 – ASP.NET Core app failed to start，
代表程式在啟動階段即發生錯誤。

需要注意的是，HTTP Error 500.30 不一定代表程式碼本身有問題，
在 Windows 虛擬主機環境中，以下情況也非常常見：

• .NET Hosting Bundle 與專案版本不相容
• 專案編譯版本與主機支援的 Runtime 不一致
• web.config 中殘留舊版設定導致啟動失敗

可透過編輯 httpdocs 目錄下的 web.config，
將 stdoutLogEnabled 設為 true，
以產生錯誤記錄檔進行排查。

其他 HTTP Error 錯誤說明

若網站出現 HTTP Error 502.5、500.31 或其他 HTTP Error 訊息，
大多也可透過上述方式進行排查。

補充說明：若網站使用的是 Classic ASP（傳統 ASP），
其錯誤顯示方式與 ASP.NET 不同，
Classic ASP 並不使用 web.config 控制錯誤顯示，
多半需透過 IIS 或主機商設定進行排查。

重要安全與使用提醒

詳細錯誤訊息僅建議於除錯期間暫時開啟，
若長時間於正式營運網站中啟用，
可能會洩漏系統路徑、資料庫連線資訊或程式結構，
亦可能影響網站效能與資訊安全。

完成錯誤排查後，請務必將相關設定恢復為關閉狀態。

常見問題

文章來源：https://wpoki.com