ASP.NET与Entity Framework应用发布到本地IIS后PDF、Excel报表无法渲染

• Visual Studio 内置调试环境运行时，PDF生成、Excel导出功能可正常触发文件下载与渲染
• 应用发布至本地IIS服务器运行时，点击导出按钮会新开浏览器标签页，标签页内仍展示原站点页面内容，无目标文件输出

1. IIS模块篡改响应头 #

正常导出逻辑需要后端在响应中指定两类核心头，引导浏览器触发文件下载：

• Content-Type：PDF对应application/pdf，Excel根据版本对应application/vnd.ms-excel或application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
• Content-Disposition：配置为attachment; filename=xxx.xxx格式，告知浏览器对返回流执行下载而非页面渲染

IIS 默认安装的动态压缩、响应过滤模块，会对未配置白名单的响应类型自动篡改头信息，将二进制流重新标记为text/html，最终导致浏览器把返回的文件内容当HTML渲染到新标签页。
解决操作：

• 在站点根目录web.config中针对导出相关路径关闭指定MIME类型的动态压缩：

  <system.webServer>
    <urlCompression doDynamicCompression="true" />
    <httpCompression>
      <dynamicTypes>
        <add mimeType="application/pdf" enabled="false" />
        <add mimeType="application/vnd.ms-excel" enabled="false" />
        <add mimeType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" enabled="false" />
      </dynamicTypes>
    </httpCompression>
  </system.webServer>
  

• 检查站点的自定义响应头过滤规则，确认没有配置规则移除Content-Disposition响应头，这类规则会直接导致浏览器无法识别下载请求。

2. 应用池权限与响应管道异常 #

• Visual Studio 调试环境默认使用当前登录用户的高权限进程运行应用，IIS发布后应用池默认使用ApplicationPoolIdentity虚拟身份运行，若代码中生成PDF/Excel需要读取系统字体、写入临时文件的目录没有给该账号开放读写权限，会导致后端流生成失败，请求直接返回当前页面的HTML内容
• 若代码在写完导出文件流后没有正确终止响应管道，后续页面渲染逻辑会把原页面的HTML内容追加到响应流末尾，浏览器解析时会识别为HTML页面，覆盖原本的文件流内容
  解决操作：
• 给IIS应用池身份账号开放系统临时目录（C:\Windows\Temp）、应用自身临时文件存储目录的读写权限
• 修正导出逻辑的响应终止代码，避免流内容被后续HTML渲染覆盖：

  // 完成文件流写入后执行
  Response.Flush();
  Response.Close();
  HttpContext.Current.ApplicationInstance.CompleteRequest();
  // 该代码之后禁止编写任何页面渲染、响应修改逻辑
  

3. 前端触发逻辑的环境适配问题 #

Visual Studio 内置的IIS Express会默认放开弹窗拦截、跨域限制，发布到独立IIS后，浏览器的安全规则会拦截不符合规范的导出请求：

• 若通过AJAX发起导出请求，没有将xhr.responseType设置为blob，会导致拿到的二进制流被错误解析为HTML文本，触发新标签页打开原页面
• 若前端通过window.open()发起GET请求调用导出接口，但后端导出接口仅允许POST方法，会触发路由重定向返回原页面内容
  解决操作：
• 统一通过同步表单提交、带Blob解析逻辑的AJAX请求触发导出，避免无规范的弹窗调用
• 校验前端请求的HTTP方法与后端导出接口的配置是否一致，避免方法不匹配导致的重定向返回原页面。

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