使用SelectPDF从CSHTML模板生成PDF时生产环境报错求助

本地用SelectPDF从CSHTML模板生成PDF完全正常，但部署到生产环境就报错，这种「本地OK生产崩」的场景，通常和环境依赖、权限或者部署完整性有关，结合你的报错堆栈（核心是ConvertHtmlString调用失败），给你几个具体的排查方向：

• 检查生产环境的系统依赖
  SelectPDF的渲染引擎（不管是旧版IE还是新版Chromium）都依赖系统组件：

  • 如果是Windows服务器：确认.NET框架版本和本地一致，且IE相关组件没有被禁用（比如脚本执行、ActiveX控件）；如果用Chromium引擎，检查是否安装了VC++运行时库。
  • 如果是Linux服务器：需要安装Chromium的依赖包，比如libglib2.0-0、libnss3、libgconf-2-4、libfontconfig1这些，不同发行版用对应的包管理器安装即可。

• 验证应用程序权限
  生产环境的服务账号（比如IIS应用池账号、Linux的运行用户）权限往往比本地开发账号低：

  • 确保账号有读写临时目录的权限：Windows下是%TEMP%，Linux下是/tmp，SelectPDF会在这些目录生成临时文件。
  • 如果CSHTML模板里引用了本地图片、样式文件，或者网络资源，确认服务账号能访问这些路径（本地文件要给权限，网络资源要确保服务器能通）。

• 重新确认DLL部署完整性
  虽然你说检查过DLL，但还是要仔细核对：

  • 确保所有SelectPDF相关的DLL都部署到了生产环境，包括辅助DLL（比如SelectPdf.Chromium.x64.dll这类），且版本和本地完全一致。
  • 检查DLL是否被损坏或者被文件锁定：可以尝试删除生产环境的DLL，重新从本地复制一份，或者用工具（比如Windows的Dependency Walker）检查DLL的依赖项是否缺失。

• 切换渲染引擎试试
  如果用的是旧版SelectPDF，默认的IE引擎可能在生产环境受限于安全设置，试试切换到Chromium引擎：

  var converter = new HtmlToPdf();
  converter.Options.WebEngine = WebEngine.Chromium;
  // 其他配置...
  var pdfDocument = converter.ConvertHtmlString(yourHtmlContent);
  

  新版本SelectPDF默认用Chromium，如果是旧版本，需要确保对应的Chromium DLL已经部署。

• 开启SelectPDF日志排查细节
  光靠堆栈信息不够，开启SelectPDF的调试日志能帮你找到具体失败原因：

  // 日志路径要确保服务账号有写入权限
  SelectPdf.GlobalSettings.LogFilePath = @"/var/log/selectpdf.log"; // Linux
  // SelectPdf.GlobalSettings.LogFilePath = @"C:\Logs\selectpdf.log"; // Windows
  SelectPdf.GlobalSettings.LogLevel = LogLevel.Debug;
  

  日志里会记录引擎初始化、资源加载、转换过程的细节，比如是否是某张图片加载失败导致整个转换崩溃。

• 检查环境变量和路径配置
  如果你自定义了Chromium的路径，要确认生产环境的路径和本地一致；如果用的是SelectPDF嵌入式的Chromium，要确保生产环境的应用程序能解压嵌入式的Chromium包（需要读写权限）。

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