ASP.NET HTTP 模組與處理常式：管線架構、實作與註冊全攻略

從 ISAPI 到 HTTP 管線的演進

早期 IIS 透過 ISAPI 擴充 (Extension) 與過濾器 (Filter) 讓開發者以 C/C++ 擴展伺服器功能，但開發門檻高、除錯困難、記憶體管理風險大。ASP.NET 重新設計請求處理管線，提供 HttpModule (HTTP 模組) 與 HttpHandler (HTTP 處理常式) 兩種 managed 代碼擴展點，大幅降低開發複雜度並提升安全性。

ASP.NET 請求處理管線流程

1. IIS 接收請求，根據副檔名對應至 aspnet_isapi.dll (經典模式) 或直接進入 managed 管線 (整合模式)。
2. 建立 HttpApplication 實例，觸發 BeginRequest 事件。
3. 請求依序通過所有註冊的 HttpModule (實作 IHttpModule)：
   每個模組可攔截、修改、記錄、短路請求 (如 context.Response.End())。
4. 管線根據 URL 對應至單一 HttpHandler (實作 IHttpHandler) 執行核心邏輯：
   .aspx → PageHandlerFactory → Page 類別；
   .ashx → 自訂 Handler；
   Web Service (.asmx) → WebServiceHandlerFactory。
5. Handler 執行完成，回應依序反向通過所有 HttpModule (觸發 EndRequest 等事件)。
6. IIS 發送回應給用戶端。

關鍵原則：一個請求只能由一個 HttpHandler 處理，但可經過多個 HttpModule。

HttpHandler 實作詳解

介面定義

Public Interface IHttpHandler
    ReadOnly Property IsReusable As Boolean  ' 實例是否可重用處理同類請求
    Sub ProcessRequest(context As HttpContext)  ' 核心處理邏輯
End Interface

範例：動態產生圖片的 Handler (.ashx)

Public Class ChartHandler : Implements IHttpHandler

    Public ReadOnly Property IsReusable As Boolean Implements IHttpHandler.IsReusable
        Get : Return True : End Get
    End Property

    Public Sub ProcessRequest(context As HttpContext) Implements IHttpHandler.ProcessRequest
        Dim width As Integer = 400, height As Integer = 300
        Using bmp As New Bitmap(width, height), g As Graphics = Graphics.FromImage(bmp)
            g.Clear(Color.White)
            g.DrawString("Dynamic Chart " & DateTime.Now.ToString("HH:mm:ss"), 
                         New Font("Arial", 14), Brushes.Blue, 10, 10)
            context.Response.ContentType = "image/png"
            bmp.Save(context.Response.OutputStream, Imaging.ImageFormat.Png)
        End Using
    End Sub
End Class

Handler Factory (IHttpHandlerFactory) 進階應用

當需根據請求參數動態決定具體 Handler 類別時，實作 IHttpHandlerFactory：

Public Class DynamicHandlerFactory : Implements IHttpHandlerFactory
    Public Function GetHandler(context As HttpContext, requestType As String, url As String, pathTranslated As String) As IHttpHandler Implements IHttpHandlerFactory.GetHandler
        Dim action As String = context.Request.QueryString("action")
        Select Case action
            Case "chart" : Return New ChartHandler()
            Case "pdf" : Return New PdfHandler()
            Case Else : Return New DefaultHandler()
        End Select
    End Function
    Public Sub ReleaseHandler(handler As IHttpHandler) Implements IHttpHandlerFactory.ReleaseHandler
        ' 可實作物件池回收邏輯
    End Sub
End Class

HttpModule 實作詳解

介面定義與事件掛鉤

Public Interface IHttpModule
    Sub Init(app As HttpApplication)
    Sub Dispose()
End Interface

Public Class SecurityModule : Implements IHttpModule
    Public Sub Init(app As HttpApplication) Implements IHttpModule.Init
        AddHandler app.BeginRequest, AddressOf OnBeginRequest
        AddHandler app.AuthenticateRequest, AddressOf OnAuthenticateRequest
        AddHandler app.AuthorizeRequest, AddressOf OnAuthorizeRequest
        AddHandler app.EndRequest, AddressOf OnEndRequest
    End Sub
    
    Private Sub OnBeginRequest(sender As Object, e As EventArgs)
        Dim app As HttpApplication = CType(sender, HttpApplication)
        ' 記錄請求 IP、URL、UserAgent
        Trace.Write("Security", $"Request from {app.Context.Request.UserHostAddress}: {app.Context.Request.RawUrl}")
    End Sub
    
    Private Sub OnAuthenticateRequest(sender As Object, e As EventArgs)
        ' 自訂驗證邏輯：檢查 Token、API Key、JWT 等
    End Sub
    
    Private Sub OnAuthorizeRequest(sender As Object, e As EventArgs)
        ' 自訂授權邏輯：角色、權限檢查
    End Sub
    
    Private Sub OnEndRequest(sender As Object, e As EventArgs)
        ' 記錄回應狀態碼、處理時間
    End Sub
    
    Public Sub Dispose() Implements IHttpModule.Dispose
        ' 清理資源
    End Sub
End Class

Web.config 註冊配置

IIS 7+ 整合模式 (system.webServer)

<system.webServer>
  <modules>
    <add name="SecurityModule" type="MyApp.Modules.SecurityModule, MyApp" />
    <remove name="FormsAuthentication" /> <!-- 移除內建模組 -->
  </modules>
  <handlers>
    <add name="ChartHandler" verb="*" path="chart.ashx" type="MyApp.Handlers.ChartHandler, MyApp" />
    <add name="DynamicFactory" verb="*" path="api/*" type="MyApp.Factories.DynamicHandlerFactory, MyApp" />
  </handlers>
</system.webServer>

傳統模式 / IIS 6 (system.web)

<system.web>
  <httpModules>
    <add name="SecurityModule" type="MyApp.Modules.SecurityModule, MyApp" />
  </httpModules>
  <httpHandlers>
    <add verb="*" path="chart.ashx" type="MyApp.Handlers.ChartHandler, MyApp" />
    <add verb="*" path="api/*" type="MyApp.Factories.DynamicHandlerFactory, MyApp" />
  </httpHandlers>
</system.web>

實戰應用場景

效能與最佳實務

• IsReusable = True：無狀態 Handler 應回傳 True，減少物件配置開銷。
• 避免在 Module 中做耗時 I/O：記錄日誌請使用非同步寫入或佇列，防止阻塞管線。
• 正確處理例外：Module 中未捕捉的例外會中斷管線，導致 500 錯誤；關鍵邏輯務必 Try/Catch。
• 整合模式下模組適用所有靜態檔案：需在 <modules runAllManagedModulesForAllRequests="true"> 或對特定路徑設定 preCondition=""。

結語

HttpModule 與 HttpHandler 是 ASP.NET 擴展管線的雙支柱：Module 處理橫切關注點 (驗證、記錄、重寫)，Handler 專注於特定請求類型的核心回應產生。掌握管線事件順序、註冊配置差異 (system.web vs system.webServer)、Factory 模式應用，能讓你在不修改核心框架的前提下，靈活實現各種進階 Web 架構需求。