Rotativa.AspNetCore 1.3.2部署至Azure后无法生成PDF，求解决方案

问题描述 #

开发环境中使用Rotativa将视图渲染为PDF运行正常，但部署到Azure后，生成PDF时流程持续加载直至触发超时错误。已尝试在根目录创建Rotativa文件夹并放入相关DLL文件，问题仍未解决，当前Rotativa文件夹内文件情况见截图。

相关Action代码 #

[HttpPost]
public IActionResult ActionName(ModelName c, string calculate)
{
    ModelState.Clear();

    c.DropDownListChange();

    if (calculate == "calculate")
    {
        c.Run();
        return View(c);
    }
    else if (calculate == "print")
    {
        c.Run();
        return new ViewAsPdf(c)
        {
            FileName = "Test.pdf",
            PageMargins = { Left = 10, Right = 10 },
            PageHeight = 700,
            PageWidth = 309.9
        };
    }
    else
    {
        return View(c);
    }
}

详细解决步骤 #

1. 确认Rotativa依赖文件完整性 #

• 确保Rotativa文件夹包含对应版本的核心执行文件：wkhtmltopdf.exe、wkhtmltoimage.exe，以及配套的x86/x64子文件夹及内部文件。
• 检查文件属性：右键文件→属性→「复制到输出目录」选择「始终复制」或「如果较新则复制」，确保部署时这些文件同步到Azure服务器。

2. 配置Azure应用服务基础设置 #

• 开启「始终开启」选项：登录Azure门户→进入目标应用服务→左侧菜单「配置」→「常规设置」→将「始终开启」设为「开启」并保存，避免应用服务休眠导致进程无法启动。
• 匹配平台位数：若项目为64位，在「配置」→「常规设置」→「平台」中选择「64位」，防止32/64位不兼容导致wkhtmltopdf无法运行。

3. 明确Rotativa路径配置 #

在Program.cs或Startup.cs中指定wkhtmltopdf的绝对路径，避免Azure环境下路径识别错误：

// 针对Rotativa.AspNetCore版本
services.AddRotativa(options =>
{
    options.WkhtmlPath = Path.Combine(Directory.GetCurrentDirectory(), "Rotativa");
});

4. 排查视图渲染本身的问题 #

• 将ViewAsPdf临时替换为普通View，在Azure环境测试该视图是否能正常加载，排除视图因静态资源缺失、数据库连接异常等导致的阻塞。
• 检查视图中引用的CSS/JS资源，确保在Azure环境可访问，避免资源加载超时拖慢PDF生成流程。

5. 增加超时设置与日志排查 #

• 临时延长Action超时时间，验证是否因生成耗时过长导致超时：

  [HttpPost]
  [Timeout(60000)] // 设置为60秒，可按需调整
  public IActionResult ActionName(ModelName c, string calculate)
  {
      // 原有代码逻辑
  }
  

• 添加异常捕获与日志记录，定位具体错误：

  try
  {
      return new ViewAsPdf(c)
      {
          FileName = "Test.pdf",
          PageMargins = { Left = 10, Right = 10 },
          PageHeight = 700,
          PageWidth = 309.9
      };
  }
  catch (Exception ex)
  {
      _logger.LogError(ex, "PDF生成失败");
      throw;
  }
  

  登录Azure门户→「监控」→「日志」，查看捕获的异常信息，精准定位问题根源。

6. 替代方案尝试（若以上方法无效） #

若Rotativa在Azure环境的兼容性问题无法解决，可尝试使用iTextSharp、PdfSharp等NuGet包，或Azure原生PDF生成服务，需注意不同方案的使用场景差异。

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