如何配置GAC中托管HttpModule兼容IIS经典与集成模式

首先得明确：集成模式和经典模式的请求管道机制差异很大，集成模式下IIS会自动把全局模块注入到所有站点的统一请求管道，但经典模式沿用了旧的ISAPI管道模型，全局模块不会自动加载到经典模式应用中，必须额外配置。

下面是具体的解决步骤：

1. 编辑applicationHost.config配置文件

   • 找到文件路径：%windir%\System32\inetsrv\config\applicationHost.config
   • 务必以管理员身份打开编辑器（比如Notepad++或VS Code），否则无法保存修改。

2. 确认全局模块已正确注册
   在文件中找到<globalModules>节点，确认你的自定义模块已经存在，格式类似：

   <globalModules>
     <!-- 其他全局模块 -->
     <!-- 若模块安装在GAC，用类型声明格式 -->
     <add name="MyCustomHttpModule" 
          type="MyAssembly.MyCustomHttpModule, MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=你的公钥令牌" />
     <!-- 若为本地DLL，用image路径声明 -->
     <!-- <add name="MyCustomHttpModule" image="C:\xxx\MyAssembly.dll" preCondition="bitness64" /> -->
   </globalModules>
   

3. 为经典模式添加模块引用
   找到<system.webServer>下的<modules>节点，添加你的模块，并指定对应预条件：

   <modules>
     <!-- 已有模块 -->
     <!-- 让模块在所有经典模式站点生效 -->
     <add name="MyCustomHttpModule" 
          type="MyAssembly.MyCustomHttpModule, MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=你的公钥令牌" 
          preCondition="classicMode" />
     <!-- 可选：仅在.NET 2经典模式站点生效 -->
     <!-- <add name="MyCustomHttpModule" type="..." preCondition="classicMode,runtimeVersionv2.0" /> -->
     <!-- 可选：仅在.NET 4经典模式站点生效 -->
     <!-- <add name="MyCustomHttpModule" type="..." preCondition="classicMode,runtimeVersionv4.0" /> -->
   </modules>
   

4. 验证模块兼容性
   确保你的自定义HttpModule完全适配经典模式：

   • 必须实现.NET 2.0的System.Web.IHttpModule接口
   • 在Init方法中注册的事件（比如BeginRequest、EndRequest）要符合经典模式的事件触发顺序
   • 避免使用集成模式特有的API（常规IHttpModule接口方法在两种模式下都兼容）

5. 重启IIS使配置生效
   打开管理员身份的命令提示符，执行命令：

   iisreset
   

完成以上操作后，经典模式的网站就能自动加载你的自定义HttpModule了，无需逐个修改站点的web.config。

内容的提问来源于stack exchange，提问作者Reza Mortazavi