如何在Windows Server 2019的IIS10中添加Managed Module

图形界面操作步骤 #

• 打开IIS管理器，定位到目标网站或具体应用程序层级
• 在功能视图中，找到并双击模块选项
• 进入模块页面后，右侧操作栏会显示添加托管模块选项（若未显示，检查是否选中了网站/应用层级而非服务器根节点，或确认IIS管理组件已完整安装）
• 在弹出的配置对话框中：
  • 输入自定义模块名称
  • 选择对应.NET程序集，或浏览到自定义模块的DLL文件
  • 填写模块类的完整命名空间+类名
  • 按需勾选“仅针对请求向ASP.NET应用程序或托管处理程序发出调用”
  • 点击确定完成添加

web.config配置生效方案 #

正确配置示例 #

确保配置节点放置在<system.webServer>下的<modules>节点中，示例如下：

<system.webServer>
  <modules>
    <add name="CustomManagedModule" type="你的命名空间.模块类名, 程序集名称" preCondition="managedHandler" />
  </modules>
</system.webServer>

配置未生效排查要点 #

• 确认程序集位置：自定义模块DLL需放在网站bin目录，或已注册到全局程序集缓存（GAC）
• 检查preCondition属性：设置为managedHandler时仅对托管请求生效；若需对所有请求生效，改为integratedMode（前提是应用池为集成管道模式）
• 验证类信息：命名空间、类名、程序集名称必须完全匹配，且类需实现IHttpModule接口
• 确认应用池模式：网站应用池需设置为集成模式，经典模式下托管模块配置逻辑不同
• 重启网站/应用池：修改web.config后必须重启才能让配置生效

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