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

排查报价单 PDF 生成错误

上次更新时间： 2026年6月29日

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

所有产品和计划

某些功能需要座位

需要订阅 A Revenue Hub 订阅才能使用报价功能。

需要座位需拥有 Revenue Hub 席位才能创建和编辑报价。

了解有关创建旧版报价单的订阅要求。

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

开始之前

新用户将无法再使用旧版报价单。 HubSpot 的 AI 驱动型 CPQ 提供了增强的报价功能，并随 Revenue HubProfessional或Enterprise账户中提供。如果您使用的是 Revenue Hub专业版或企业版账户，请了解如何创建报价。

非Revenue Hub 2025年9月3日之前创建的非Revenue Hub专业版或企业版账户可能仍可访问旧版报价单：

免费账户用户：若在2025 年 9 月 3 日前六个月内创建过一份或多份报价，则可访问旧版报价。
Sales Hub账户的用户：在 2025 年 9 月 3 日之后仍可访问旧版报价单。

查看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 状态。请确认报价单链接能否在浏览器中正常加载。如果问题仍然存在，请召回并重新发布该报价单。