IIS 7 應用程序池托管管道模式深度解析：經典 vs 集成完整對比

前言

IIS 7 引入**應用程序池托管管道模式**選項：經典 與 集成。這不僅是兼容性開關，更決定了請求處理架構、配置體系、擴展能力。本文從架構原理、配置差異、遷移工具、常見錯誤 (500.22)、HTTP 錯誤頁配置、模塊替換擴展六個維度深度解析。

一、架構原理對比

經典模式

• ASP.NET 作為 **ISAPI Extension** (`aspnet_isapi.dll`) 外掛到 IIS
• IIS 先處理請求，按擴展名分派：.aspx → ASP.NET，.html → 靜態文件，.asp → ASP.dll
• **雙管道並行**：IIS 原生管道 + ASP.NET 托管管道
• 托管模塊 (FormsAuth、Session、Cache) **僅處理 ASP.NET 請求**

集成模式

• ASP.NET 運行時組件直接集成到 **IIS 請求處理管道**
• IIS 功能拆解為 40+ **原生模塊** (StaticFile、Authentication、Compression...)
• ASP.NET 模塊 (FormsAuth、Session、Profile、RoleManager、OutputCache) 成為 **管道一等公民**
• **單一管道**：所有請求 (靜態/動態/ASP/PHP) 統一流經托管模塊
• 托管功能可應用於非 ASP.NET 內容：PHP 頁面也能用 Forms 認證、輸出緩存

二、配置體系核心差異 (web.config)

三、遷移工具：appcmd.exe 自動轉換

# 命令行遷移經典配置為集成配置
%windir%\system32\inetsrv\appcmd.exe migrate config "Default Web Site/MyApp"

# 輸出示例：
# Migrated configuration for 'Default Web Site/MyApp'
#    -> 
#    -> 
#    ->  (部分)

遷移後**必須人工檢查**：`customErrors` → `httpErrors` 轉換不完全，需手動補充 `errorMode`、`responseMode`。

四、經典錯誤：HTTP 500.22 - 集成模式下使用舊配置

錯誤訊息：

HTTP Error 500.22 - Internal Server Error
An ASP.NET setting has been detected that does not apply in Integrated managed pipeline mode.

原因：集成模式應用中存在 ``、``、`` 等經典專用配置。

解決：

1. 運行 `appcmd migrate config` 自動遷移
2. 手動將 `` 移至 ``
3. 手動將 `` 移至 ``
4. 移除 `` (集成模式不支持，改用應用程序池標識)

五、HTTP 錯誤頁配置：httpErrors vs customErrors

集成模式正確配置 (web.config)

屬性詳解

customErrors (應用程序級錯誤) 依然生效

優先級：`Application_Error` 事件 > `customErrors` > `httpErrors` (IIS 級)。

六、模塊替換與擴展：打造定制管道

集成模式允許**完全替換內置模塊**：

甚至可編寫**純托管 IIS 管理工具** (Microsoft.Web.Administration API) 程序化創建站點、應用程序池、虛擬目錄。

七、選型決策表

總結

**集成模式是 IIS 7+ 核心架構**，將 ASP.NET 從外掛提升為管道原生組件，實現單一管道、統一模塊、托管功能通用化。遷移關鍵在於 `` → `` 配置轉換，利用 `appcmd migrate config` 加速。新項目**強制集成模式**，舊項目評估遷移成本後決定。掌握 `httpErrors`、`modules`、`handlers` 三大節點，掌控完整請求處理生命周期。