上次更新时间： 2026年8月18日
可与以下任何订阅一起使用，除非另有说明：
-
营销 Hub
Professional, Enterprise
-
销售 Hub
Professional, Enterprise
-
Service Hub
Professional, Enterprise
-
Data Hub
Professional, Enterprise
-
内容 Hub
Professional, Enterprise
-
智能 CRM
Professional, Enterprise
-
Revenue Hub
Professional, Enterprise
-
需要 HubSpot 点数
在将内容源与客户代理同步时，您可能会遇到错误。请参阅下文，了解如何查看内容源的同步状态并排查常见错误，以确保您的客户代理使用的是最新内容。
查看已添加到客户代理中的内容源的同步状态
在排查特定错误之前，请先检查已添加内容源的同步状态：
- 在你的 HubSpot 帐户中，单击更多，然后导航到服务 > 客户代理。如果你的帐户中未显示更多，请直接导航到服务 > 客户代理。
- 在左侧边栏菜单中，点击“训练”>“知识库”。
- 在表格的右上角，点击“失败”选项卡 。
- 在表格中，查看未能同步的具体内容来源及其相关的错误信息。
了解并排查内容源错误
此该 知识源已不存在或无法访问
错误含义
无法检索到内容。出现此情况通常是因为 URL 返回了404 未找到错误 、无法定位域名，或者内容已被删除。
如何解决此错误
-
确认 URL 是否正确，且该页面对公众开放。
-
检查网站的安全设置（例如防火墙），这些设置可能会阻止爬虫访问。
-
如有必要，请与团队中的开发人员合作，将 IP 范围 54.174.58.224/27 加入该页面的白名单。您还可以 使用 IP 范围 API获取 HubSpot 使用的最新 IP 地址列表。
无法加载网站内容
错误含义
爬虫无法加载或渲染该页面。这通常是由页面上的复杂 JavaScript 代码引起的。
如何解决此错误
- 简化页面上的代码。
- 将内容复制并粘贴到一个更简单的网页中，或将其作为文档（PDF、DOCX）上传。
网站返回了意外响应
错误含义
该网站的响应方式无法被爬虫识别。例如，存在过多的重定向或不支持的状态码。
如何解决此错误
-
请联系您的网站管理员或开发人员，检查是否存在重定向循环或异常状态码。
-
如有必要，请修正重定向配置并重新提交内容。
网站中的 robots.txt 文件阻止了抓取
该错误含义
该网站的 robots.txt 文件中包含一些规则，不允许我们的爬虫访问该页面。 HubSpot 爬虫遵循 此标准协议。
如何解决此错误
请联系您的网站管理员或开发人员，要求他们将我们爬虫的用户代理“HubSpot Crawler”作为例外添加到允许列表中了解有关 使用 robots.txt 文件的更多信息。该页面被阻止供自动化工具读取
此 错误含义
页面 HTML 头部中的“noindex”元标签阻止了页面被索引或抓取。
如何解决此错误
从页面中移除“noindex”元标签。
无法加载该页面，因为它是私有的或被屏蔽的
错误含义
爬虫收到了 401、403 或类似错误。该页面很可能受保护、需要登录，或被防火墙屏蔽。
如何解决此错误
-
将页面设为公开访问。
-
如果内容为私有内容，请改以 PDF/DOCX 格式上传。
-
请与您的网站管理员或团队中的开发人员合作，确保您尝试添加的页面未屏蔽或过滤 IP 范围 54.174.58.224/27。您还可以使用 IP 范围 API获取 HubSpot 使用的最新 IP 地址列表。
无法同步此内容，因为其 URL 缺少
错误含义
HubSpot 页面（网站和落地页、博客文章等）需要有效的 URL，以便系统加载。所链接的 URL 要么为空，要么无效。
如何解决此错误
请按照本文中的步骤更新 HubSpot 内容的 URL。然后，请尝试再次添加该内容。
该网站出现服务器问题，可能是由于停机或安全策略导致的
错误含义
服务器返回了通用错误（500 或 503）。这通常表明网站暂时无法访问，或者服务器正在主动阻止 HubSpot 爬虫。
如何解决此错误
- 访问该网址，确认页面能否正常加载。
- 如果页面加载正常，则可能是网站正在阻止 HubSpot 爬虫。请与您的网站管理员或团队中的开发人员合作，确保 IP 范围 54.174.58.224/27 未被阻止。您还可以使用 IP 范围 API获取 HubSpot 使用的最新 IP 地址列表。
HubSpot 内容尚未发布，因此无法同步
错误含义
您尝试添加的 HubSpot 托管内容当前处于草稿状态，尚未发布。
如何解决此错误
请发布该页面，然后再次尝试添加内容。如果您不想让内容对公众可见，请了解如何将内容设为私有。
由于内容策略，无法同步内容
错误含义
HubSpot 无法对该内容进行索引，因为它可能违反了HubSpot 的 服务条款 或 《可接受使用政策》。
如何解决此错误
-
请检查内容，并删除或更新任何可能违反HubSpot 内容政策的内容。
-
更新内容后，请尝试再次添加。
-
如果您认为该内容是被错误标记的，请联系HubSpot 支持团队，并提供受影响的内容来源 URL。
内容引用无效
错误含义
HubSpot 无法同步该内容，因为无法找到所链接的 HubSpot 内容来源，或者该来源已失效。如果内容已被删除，或者来源不再指向现有的 HubSpot 页面或博客文章，就会出现这种情况。
如何解决此错误
-
请确认该 HubSpot 内容仍然存在且已发布。
-
删除受影响的内容来源，然后使用正确的 HubSpot 内容（例如网站页面或博客文章）重新添加。
-
如果重新添加内容源仍无法解决问题，请联系HubSpot 支持团队。
此文件类型不受支持，因此内容未同步
错误含义
您尝试添加的文件格式不受支持。 客户代理支持以下文件类型：
.docx、.htm、.xhtml、.cfg、.pptx、.mpg、.conf、.mpeg、.csv、.json、.html、.text、.txt、.mp4、.pdf、.rst、.avi、.mov、.xml、.md 和 .webm。
如何解决此错误
将文件转换为上述支持的格式之一，然后尝试再次添加内容。
文档超过大小限制，因此未被处理
错误含义
文件过大。客户代理支持：
- HTML/XHTML 文件：最大 25 MB
- 所有其他文件：最大 500 MB
如何解决此错误
请尝试将文件拆分为两个或多个较小的文件，然后再次尝试添加内容。
无法建立安全连接，因此无法抓取该页面
错误含义
尝试建立安全的 HTTPS 连接时发生错误。服务器证书可能已过期或无效，或者服务器可能使用了过时的 TLS 配置。
如何解决
- 访问该网址以确保页面能正常加载。
- 如果浏览器显示证书错误，请与网站管理员或开发人员联系，以更新或正确配置网站的SSL/TLS 安全证书和 设置。
