IronPDF 中 Chrome 浏览器依赖关系的故障排除
Google Chromium HTML渲染器是IronPDF的“Html To PDF”渲染过程中的重要组成部分。 此渲染器的必需二进制文件应该可以在IronPDF NuGet包中轻松找到。 项目文件夹中缺少此二进制文件将引发以下错误:
Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'
如果 IronPDF 无法自动部署 Chrome 依赖项,则可能需要通过 NuGet 手动将它们添加到项目中。 可以添加多个依赖项:
- IronPdf.Native.Chrome.Windows
- IronPdf.Native.Chrome.Linux
请注意
在IronPDF的后续版本中,如果项目文件夹中缺少所需的二进制文件,将根据运行时使用的操作系统从NuGet源自动下载这些文件。 只要项目连接到互联网并且对项目文件夹具有读取、写入和执行的权限,这将会成功。在Windows上,最好确保目标操作系统具有Visual C++ 运行时已安装。 许多现代应用程序离不开这个必要的操作系统组件。
Linux
- 确保使用正确的 Docker 文件
- 使用 IronPdf.Linux NuGet 包,而不是 IronPdf。
- 将
IronPdf.Installation.ChromeGpuMode=IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
设置为_DISABLED。 - 设置
Installation.LinuxAndDockerDependenciesAutoConfig=false;
MacOs
* 检查 Dotnet 运行时设置是否正确 - x64 或 arm64
如果那不能解决问题怎么办?
如果这不能解决问题,我们随时愿意提供帮助。兼容性是我们工程团队的重中之重。 请将电子邮件错误报告发送至 support@ironsoftware.com 。 所有兼容性问题都将由高级工程师认真审查。
请务必告诉我们您要部署到的操作系统/平台,尤其是如果它是像AWS或Azure这样的云平台。
如何在IronPDF中启用原生日志记录
将日志文件附加到错误报告中,将使我们隔离问题并迅速解决的可能性增加一倍以上。
在运行任何IronPDF方法之前,请将此放置在代码的顶部。(2021.3.1 之后的所有版本).
IronPdf.Logging.Logger.LogFilePath = "Default.log"; //May be set to a directory name or full file
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
IronPDF 创建的日志文件位于项目的 /bin 目录中,您的 DLLs 部署在这里:
default.log(部署过程)
cef.log(效果图)
IronSoftwareCefSubprocess.log. (渲染和线程)
IronSoftwareEngine.log (用于调试以 "从......生成 PDF 出错 "开头的异常。)