ASP.NET 常見 Runtime Error 錯誤與自訂錯誤頁面配置 (web.config customErrors)

預設 ASP.NET 隱藏詳細錯誤資訊，僅顯示通用「Runtime Error」頁面。本文說明如何透過 web.config <customErrors> 控制錯誤顯示行為，並設定友善自訂錯誤頁面。

預設行為

• 遠端瀏覽器：看不到詳細錯誤 (安全考量)。
• 本機瀏覽器：可見完整堆疊追蹤。

customErrors 三種模式

配置範例

1. 開發階段：關閉自訂錯誤，看完整堆疊

<configuration>
  <system.web>
    <customErrors mode="Off" />
  </system.web>
</configuration>

2. 生產環境：顯示友善錯誤頁

<configuration>
  <system.web>
    <customErrors mode="RemoteOnly" defaultRedirect="~/Error/General.aspx" />
  </system.web>
</configuration>

3. 進階：依 HTTP 狀態碼導向不同頁面

<customErrors mode="On" defaultRedirect="~/Error/General.aspx">
  <error statusCode="404" redirect="~/Error/404.aspx" />
  <error statusCode="500" redirect="~/Error/500.aspx" />
</customErrors>

注意事項

• defaultRedirect 路徑建議使用應用程式相對路徑 (~/)。
• 錯誤頁面本身不應拋出例外，否則會陷入無限循環。
• 搭配 Application_Error (Global.asax) 記錄日誌、發送告警。
• ASP.NET Core 請使用 app.UseExceptionHandler / app.UseStatusCodePages 中介軟體。