Blazor使用wkhtmltopdf调试正常 部署IIS后PDF加载失败如何解决

报错现象：Blazor项目本地调试时wkhtmltopdf生成PDF功能正常，部署到IIS后打开PDF页面弹出「Error Failed to load PDF document」

根因定位 #

导致该问题的核心原因是PDF生成时使用的源路径与IIS运行环境的实际路径不匹配，可按照以下步骤排查修复：

修复步骤 #

• 替换硬编码路径，使用运行时动态获取的路径
  不要写死本地绝对路径，通过注入IWebHostEnvironment接口获取站点运行时目录，示例用法：

  // 服务端注入
  private readonly IWebHostEnvironment _webHostEnv;
  public PdfService(IWebHostEnvironment webHostEnv)
  {
      _webHostEnv = webHostEnv;
  }
  // 拼接路径示例
  var htmlTemplatePath = Path.Combine(_webHostEnv.WebRootPath, "templates", "report.html");
  var outputPdfPath = Path.Combine(_webHostEnv.WebRootPath, "temp", $"{Guid.NewGuid()}.pdf");
  

  确保生成的PDF文件存放在wwwroot下的可访问目录，同时给对应目录开通IIS运行身份的读写权限。
• 检查IIS权限配置
  确认站点对应的应用程序池身份对以下目录有读取+执行权限：
  1. wkhtmltopdf.exe的存放目录
  2. 站点的wwwroot目录
     测试阶段可临时将应用程序池标识改为「LocalSystem」验证权限问题，生产环境建议单独配置最小权限账号。
• 校验程序架构匹配
  确认部署的wkhtmltopdf版本和IIS配置匹配：如果服务器是64位系统，优先使用64位版wkhtmltopdf，同时检查IIS应用程序池的「启用32位应用程序」开关和你使用的exe架构一致，避免执行失败生成空PDF。
• 路径映射校验
  如果站点部署在IIS的子应用下，前端请求PDF的路径需要加上子应用前缀，不要直接用根路径/temp/xxx.pdf，可使用~/temp/xxx.pdf的相对路径写法让框架自动适配站点路径。

排查小技巧 #

生成PDF后可增加日志记录，输出生成文件的绝对路径、文件大小：如果文件大小为0说明wkhtmltopdf执行失败，优先排查exe调用权限、参数问题；如果文件正常存在，优先排查前端请求路径的映射问题。

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