请注意：：本文仅为方便您阅读而提供。

排除报价 PDF 生成错误的故障

上次更新时间： 2026年4月17日

可与以下任何订阅一起使用，除非另有说明：

所有产品和计划

某些功能需要座位

发布报价或旧版报价时，系统会自动生成 PDF 版本。如果 PDF 生成失败，报价单会记录该错误，以便您在将报价发送给买家之前检查问题。您可以在报价编辑器或报价预览面板中查看 PDF 生成状态和错误详情。了解报价与旧版报价之间的区别。

查看 PDF 生成错误

从报价索引页面查看 PDF 生成错误。

在 HubSpot 帐户中，导航到商务 > 报价。
将鼠标悬停在报价单上，然后点击“预览”。
PDF 生成错误将显示在右侧面板中。

PDF 生成错误及解决方法

下表详细列出了您可能遇到的 PDF 生成错误，并提供了相应的解决步骤。

请注意：若发布新报价时报价恢复为草稿状态，这是由于 PDF 生成过程中出现错误而采取的保护措施。遇到此类情况，请先查看 PDF 生成错误，然后参考下表中针对该错误的建议解决方案。

错误	错误含义	解决该错误的步骤
MISSING_SLUG	该报价缺少 URL 别名，而这是生成报价公共 URL 所必需的。	打开该报价，然后将其召回并重新发布。发布过程中会自动分配 slug。如果重新发布后仍缺少 slug，请联系HubSpot 支持团队。
MISSING_DOMAIN	报价未分配托管域名。生成 PDF 格式的报价页面需要域名进行托管。	请确保报价已关联域名。若已关联域名，请召回并重新发布该报价。若未关联域名，请先关联域名，然后召回并重新发布该报价。
QUOTE_RENDER_FAILED	无法渲染报价页面。没有已发布的页面可供转换为 PDF。	复制报价链接并在浏览器中打开。如果页面显示 404 或其他错误，请撤回并重新发布该报价。如果重新发布仍无法解决此错误：对于旧版报价，请召回并编辑该报价。更改模板后重新发布报价。如果使用其他模板能解决问题，则说明该模板可能存在配置问题。对于报价，请撤回该报价并使用其他模板创建新报价。
INVALID_HOST	无法访问报价的域名。HubSpot 无法解析该域名以加载报价页面。	在 HubSpot 帐户中，单击顶部导航栏中的 “设置”图标。在左侧边栏菜单中，导航至内容 > 域名与URL。复制用于生成报价的域名，并在浏览器中打开该域名。如果域名无法加载，可能是 DNS 配置有误。如果您最近连接或更改了域名，请等待最多 48 小时，以便 DNS 更改生效。然后，重新调用并重新发布报价。如果该域名已被移除，请设置一个新的报价域名，然后召回并重新发布该报价。
MISSING_SIGNATURE_AREA	该报价单将电子签名设为接受方式，但在报价页面上找不到签名模块。HubSpot 在生成 PDF 时会渲染模板并检查签名模块。若缺少签名模块，则无法生成 PDF。	如果报价单不需要电子签名，请将其召回，关闭电子签名设置，然后重新发布。如果报价单需要电子签名，请复制报价单链接，在浏览器中打开，并检查页面上是否显示签名模块。如果未显示签名模块，请编辑报价单模板，确保已包含电子签名模块。如果签名模块在浏览器中显示正常，请撤回并重新发布报价单以再次尝试。
MISSING_SIGNATURE_ASSETS	该报价单已将电子签名设为接受方式，但所使用的自定义报价模板中未包含所需的电子签名内容模块或资源。HubSpot 在生成 PDF 时会渲染模板并检查签名模块。若缺少签名模块，则无法生成 PDF。	请编辑该报价单所使用的报价模板。在模板中，请确保已添加电子签名模块及其必需组件。您也可以克隆一个包含电子签名模块的有效模板，并进行对比。更新模板后，请重新调用并重新发布该报价单。
PDF_TOO_SMALL	生成的 PDF 为空白或几乎为空。这通常意味着在捕获 PDF 之前，报价单页面尚未完全加载。	复制报价链接并在浏览器中打开。如果报价能正常加载，则很可能是临时问题。请召回并重新发布该报价。如果报价单在浏览器中加载缓慢，请编辑该报价单所用的模板。缩小大图片、移除外部脚本并简化布局。
PDF_NOT_FOUND	生成后无法找到 PDF 文件。这通常是文件存储方面的临时问题，通常会自动解决。	请等待几分钟，然后再次检查报价。如果错误仍然存在，请召回并重新发布该报价以生成新的 PDF。
INTERNAL_ERROR	生成 PDF 时发生意外错误。这可能是由于报价页面加载缓慢或服务短暂中断等临时问题引起的。	请稍等几分钟后再次查看报价。如果错误仍然存在，请复制报价链接并在浏览器中打开：如果页面无法加载或显示错误，请取消发布该模板。查找并修复模板中的潜在问题，然后重新发布。如果页面加载时间超过 30 秒，请编辑用于生成报价的模板。缩小大图片、移除外部脚本并简化布局。如果页面成功加载，请召回并重新发布报价。如果错误影响多个报价，请联系HubSpot 支持团队。
INTERNAL_CLIENT_ERROR	请求错误导致无法生成 PDF。这通常意味着 PDF 服务无法访问报价页面。	复制报价链接并在浏览器中打开。如果页面能加载，请撤回并重新发布报价单以生成新的 PDF。如果问题仍然存在，请联系HubSpot 支持团队，并提供您的报价单 ID 和 HubSpot 账户详细信息。
CONTENT_NOT_PUBLISHED	报价页面尚未发布。没有页面可生成 PDF。	如果报价已被作废，则会出现此错误。已作废的报价不会生成 PDF。如果报价尚未作废，请撤回并重新发布该报价。
CONTENT_UNAVAILABLE	报价页面内容暂时不可用。此错误通常会自动解决。	请等待几分钟后再次检查 PDF 状态。请确认报价链接能否在浏览器中正常加载。如果问题仍然存在，请召回并重新发布该报价。