Windows Server 2019（IIS 10）中Report Viewer配置错误求助

我之前帮客户迁移Report Viewer站点到Win2019 IIS10时也碰到过一模一样的问题，常规的IIS7+方案不管用，最后是几个细节没处理到位导致的，给你一步步排查解决：

1. 确保Web.Config中Handler配置的版本完全匹配 #

首先，别只复制网上的模板，一定要把配置里的ReportViewer版本号改成你项目实际引用的版本（比如15.0.0.0，或者你用的旧版本），两个节点都要同步修改：

在<system.web>节点下添加： #

<httpHandlers>
  <add verb="*" path="Reserved.ReportViewerWebControl.axd" 
       type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=15.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" />
</httpHandlers>

在<system.webServer>节点下添加： #

<handlers>
  <add name="ReportViewerWebControlHandler" preCondition="integratedMode" 
       verb="*" path="Reserved.ReportViewerWebControl.axd" 
       type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=15.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" />
</handlers>

注意：版本号要和你项目bin目录里的Microsoft.ReportViewer.WebForms.dll、Microsoft.ReportViewer.Common.dll版本完全一致，PublicKeyToken也要对应（右键dll看属性里的详细信息即可获取）。

2. 强制关闭IIS集成模式的配置验证 #

Win2019的IIS10对集成模式的配置验证更严格，在<system.webServer>节点里加这行，避免不必要的验证错误：

<system.webServer>
  <validation validateIntegratedModeConfiguration="false"/>
  <!-- 其他已有配置 -->
</system.webServer>

3. 检查IIS模块映射是否正确注册 #

有时候即使Web.Config配置了，IIS的模块映射里可能没有同步，手动添加一下：

1. 打开IIS管理器，找到你的站点，点击模块映射
2. 右侧点击添加托管处理程序
3. 填写信息：
   • 请求路径：Reserved.ReportViewerWebControl.axd
   • 类型：和Web.Config里的type完全一致（比如Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=15.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91）
   • 名称：ReportViewerWebControlHandler
4. 确认预条件是集成模式，点击确定

4. 安装对应版本的ReportViewer运行时 #

Win2019默认没有预装ReportViewer的运行时环境，必须手动安装：

• 如果用的是ReportViewer 2019（版本15.x），安装Microsoft Report Viewer 2019 Runtime
• 如果是旧版本（比如11.x），安装对应的Microsoft Report Viewer 2012 Runtime
  安装完成后一定要重启IIS（命令行输入iisreset）

5. 核对应用程序池设置 #

确保你的站点应用程序池满足两个条件：

• .NET框架版本和项目目标框架一致（比如项目用.NET 4.7.2，池也要设为v4.0）
• 托管管道模式必须是集成模式（经典模式在IIS10下会导致Handler注册失败）

6. 检查文件权限和bin目录完整性 #

• 确认站点bin目录里有Microsoft.ReportViewer.WebForms.dll、Microsoft.ReportViewer.Common.dll、Microsoft.ReportViewer.ProcessingObjectModel.dll这几个核心文件
• 应用程序池的身份（比如默认的ApplicationPoolIdentity）对这些文件有读取权限

按这个顺序排查，基本能解决问题，我当时就是漏装了运行时，加上版本号写错了导致折腾了半天。

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