ASP.NET Core 5发布后Rotativa.AspNetCore导出PDF报错求助

Rotativa.AspNetCore本地调试正常、发布后报错是典型的部署适配问题，按以下优先级逐一排查即可解决：

1. 未显式配置wkhtml工具路径（90%同类问题的根因） #

VS本地运行时的进程工作目录，和发布后IIS/Windows服务的工作目录完全不一致，Rotativa默认的相对路径查找逻辑根本定位不到wkhtmltopdf.exe，哪怕你已经手动把两个exe放到了Rotativa文件夹下。
直接在项目Startup.cs的Configure方法中添加显式路径配置，路径要和你Rotativa文件夹的实际存放位置一致：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 保留你原有的其他配置逻辑
    // Rotativa文件夹放在wwwroot下就传env.WebRootPath，放在项目根目录就传env.ContentRootPath
    RotativaConfiguration.Setup(env.WebRootPath, "Rotativa");
}

2. 部署目录权限不足 #

本地调试时程序用你当前登录的Windows用户身份启动，对项目下所有文件有完整读写执行权限；发布到IIS后默认用应用程序池的低权限标识运行，没有exe的执行权限时会直接抛进程启动失败，很多时候不会在普通日志里留明确记录。
操作步骤：

• 打开发布后站点根目录，找到Rotativa文件夹
• 右键打开「属性-安全」标签，给IIS_IUSRS用户组授予读取、读取和执行、列出文件夹内容权限
• 保存后重启对应应用池再测试

3. 缺少wkhtml运行依赖 #

wkhtmltopdf.exe是基于QT开发的原生程序，依赖Microsoft Visual C++ 2015-2019运行库，开发机安装VS时会默认预装这个依赖，大部分生产服务器不会自带。
验证方式很简单：直接在服务器上双击运行Rotativa文件夹里的wkhtmltopdf.exe，如果弹出“缺少VCRUNTIME.dll”之类的提示，安装和wkhtml位数匹配的VC++运行库即可（32位exe装x86版，64位exe装x64版）。

4. 发布时遗漏必要文件 #

两个高频漏发的文件：

• 确认RibExport.cshtml视图文件被正确发布到站点的对应视图目录，很多人发布配置默认不拷贝视图文件，本地存在视图所以运行正常，发布后找不到视图直接触发500错误
• 确认两个wkhtml的exe文件在项目中的属性设置为「如果较新则复制」，避免发布流程漏拷这两个原生程序

5. 临时开启开发环境拿精准错误栈 #

如果以上步骤排查完还没解决，别靠猜。临时在站点的web.config里把环境变量改成Development，重启站点后再访问导出接口，就能看到完整的异常堆栈信息，直接定位具体错误点：

<environmentVariables>
  <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
</environmentVariables>

问题修复后记得把环境值改回Production，避免向终端用户泄露敏感的异常信息。

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