1. IronPDF
  2. 故障排除
  3. 渲染PDF时超时

呈现 PDF 时超时

This article was translated from English: Does it need improvement?
Translated
View the article in English
  • 无法从 HTML 渲染 PDF
  • 无法从 URL 渲染 PDF
  • 从 HTML 生成 PDF 时出现错误

  • 从 URL 生成 PDF 时出错

  • 未指定的本地异常

这些通用错误信息表示 Chrome 浏览器渲染引擎出现故障。

应用下面的代码片段将生成 "Default.log "日志文件，有助于确定故障原因

IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
IronPdf.Logging.Logger.LogFilePath = "Default.log";

渲染超时

超时（Timeout）是 IronPDF 中实现的一项功能，用于防止应用程序因 PDF 渲染时间过长而出现死锁或反应迟钝，这主要有助于用户管理资源，确保 CPU、内存和网络带宽等资源不会被耗时过长的进程占用。如果 PDF 渲染过程没有及时完成，就会出现如下超时错误。

  • 从 HTML 渲染 PDF 时_60 秒后超时
  • 从 URL 呈现 pdf 时 _60 秒后超时
  • 从 HTML 生成 PDF 时的超时
  • 从 URL 生成 PDF 时超时
  • 从 HTML 渲染 PDF 时超时
  • 从 URL 生成 PDF 时超时

导致 IronPDF 渲染时间过长的原因有很多，例如渲染大型或重型 PDF、检索远程资源/资产以渲染 PDF 或渲染过程中出现问题。不过，重写超时持续时间通常可以解决问题。

要覆盖默认设置，用户可以访问 超时属性 类中的 ChromePdfRenderOptions 并将其设置为更高值。

RenderingOptions.Timeout = 120; // seconds;

请注意
从 2021.12.4995 版开始，IronPDF 的默认渲染超时时间为 60 秒。

渲染延迟

在某些情况下，IronPDF 会渲染

  • 空白 PDF

  • 内容不完整的 PDF

  • 缺少图像资产的 PDF

    出现这种问题的原因可能是，在调用资源检索内容或资产之前，PDF 文档已经渲染，但没有及时完成。

对 PDF 呈现器应用 RenderDelay 通常有助于解决这一问题。这将指示呈现器在设定的时间内延迟 PDF 呈现，以便在 PDF 呈现之前及时加载内容或资产。为此，只需访问 渲染延迟() 方法，将所需的持续时间设置为方法参数，并将其作为 ChromePdfRenderOptions 属性之一应用于渲染器。

RenderingOptions.WaitFor.RenderDelay(5000);  //miliseconds

请注意
默认渲染延迟时间为 20 毫秒

除了渲染延迟() 方法中的其他方法。 等待 封装对象。

有关日志和向我们的工程师报告错误以供审查的更多信息，请参阅 如何提出IronPDF的工程支持请求.