ASP.NET Web.config 核心配置詳解與最佳實踐指南

Web.config 概述

Web.config 是 ASP.NET Web 應用程式的核心設定檔，採用 XML 格式儲存應用程式的各項配置資訊，例如驗證模式、連接字串、錯誤處理、Session 狀態等。每個目錄都可擁有獨立的 Web.config，子目錄會自動繼承父目錄的設定，並可透過新增或覆寫方式自訂專屬配置。

修改 Web.config 後無需重啟服務即時生效（<processModel> 區段除外），且支援擴展自訂配置區段與處理程式，極具彈性。

核心配置區段詳細說明

1. configSections - 定義配置區段與命名空間

用於宣告自訂配置區段的處理常式與型別對應，支援 section、sectionGroup、clear、remove 等元素，確保配置結構的可擴展性。

2. appSettings - 應用程式全域常數

以鍵值對形式儲存全域常數設定，如錯誤頁面網址、功能開關等，程式碼中可透過 ConfigurationManager.AppSettings["Key"] 讀取。

3. connectionStrings - 資料庫連接字串

集中管理資料庫連線資訊，支援加密保護敏感資料，程式碼中以 ConfigurationManager.ConnectionStrings["Name"].ConnectionString 取得。

4. location - 鎖定特定資源配置

透過 path 指定套用路徑，allowOverride="false" 可防止子目錄覆寫，提升安全性。

5. system.web - ASP.NET 執行階段核心行為控制

• identity：控制應用程式身分識別模擬設定
• pages：頁面層級預設屬性（主版頁、佈景主題、ViewState、請求驗證等）
• customErrors：自訂錯誤頁面（On/Off/RemoteOnly 三種模式）
• trace：追蹤診斷功能，支援輸出模式、儲存筆數、排序方式
• compilation：編譯設定（Debug 模式、預設語言、批次編譯、組件參考、建置提供者）
• authentication / authorization：驗證模式與授權規則
• globalization：全球化編碼設定
• sessionState：Session 模式與參數
• httpRuntime：請求佇列、執行逾時、上傳大小限制
• httpModules / httpHandlers：HTTP 模組與處理常式管線
• caching：快取設定與輸出快取設定檔

6. system.net - 網路通訊設定

涵蓋 SMTP 郵件、Proxy 代理、請求快取等網路層參數。

7. system.webServer - IIS 7+ 整合模式專用

取代舊版 httpModules/httpHandlers，支援模組與處理常式在整合管線中的註冊。

8. system.web.extensions - ASP.NET AJAX 設定

包含 JSON 序列化長度限制等 AJAX 專屬參數。

9. system.serviceModel - WCF 服務設定

定義服務端點、繫結、合約、行為與中繼資料發佈。

10. rewriter - URL 重寫規則

以正規表示式將友善 URL 對應至實體頁面，提升 SEO 與使用者體驗。

最佳實踐建議

• 敏感資訊（連線字串、金鑰）務必加密儲存
• 生產環境關閉 debug="true"、trace enabled="true"、詳細錯誤訊息
• 善用 location 鎖定關鍵路徑防止被覆寫
• 依環境（開發/測試/正式）維護對應的 config 轉換檔
• 定期審查自訂模組與處理常式，移除未使用項目

掌握 Web.config 的完整結構與各區段用途，能讓 ASP.NET 應用程式在部署、維護、擴展上更具彈性與安全性。