上次更新时间： 2025年11月26日
可与以下任何订阅一起使用，除非另有说明：
-
营销 Hub
Professional, Enterprise
-
销售 Hub
Professional, Enterprise
-
Service Hub
Professional, Enterprise
-
Data Hub
Professional, Enterprise
-
内容 Hub
Professional, Enterprise
-
智能 CRM
Professional, Enterprise
-
Commerce Hub
Professional, Enterprise
-
需要 HubSpot 点数
在与客户代理同步内容源时，您可能会遇到错误。下面将介绍如何查看内容源的同步状态并排除常见错误，以确保客户代理使用的是最新内容。
查看添加到客户代理的内容源的同步状态
在排除特定错误之前，请检查所有已添加内容源的同步状态：
- 在 HubSpot 帐户中，导航到服务 > 客户代理。 本地导航客户代理
- 导航至 " 管理 " 选项卡。
- 在左侧边栏菜单中，单击 内容源。
- 在表格右上方，单击 "失败 "选项卡。
- 在表中，查看同步失败的具体内容源及其相关的错误信息。
了解内容源错误并排除故障
知识源已不存在或无法访问
错误的含义
无法检索到内容。如果 URL 返回404 Not Found 错误、域名无法定位或内容已删除，就会出现这种情况。
如何解决该错误
-
确认 URL 是否正确，页面是否可公开访问。
-
检查网站的安全设置（如防火墙）是否可能阻止爬虫。
-
如有必要，与团队中的开发人员合作，允许在页面上列出 IP 范围 54.174.58.224/27。
网站内容无法加载
错误含义
爬虫无法加载或呈现页面。这通常是由页面上复杂的 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 未被阻止或过滤。
由于 URL 丢失，因此无法同步该内容
错误含义
HubSpot 页面（网站和登陆页面、博客文章等）需要一个有效的 URL，这样系统才能加载它们。链接的 URL 要么空白要么无效。
如何解决该错误
按照本文的步骤更新 HubSpot 内容的 URL。然后，尝试再次添加内容。
网站服务器出现问题，可能是由于停机或安全策略造成的
错误含义
服务器响应的是一般故障错误（500 或 503）。这通常表示网站暂时宕机，或服务器主动阻止 HubSpot 爬虫。
如何解决该错误
- 访问 URL，确保页面加载正常。
- 如果页面加载正常，则可能是网站阻止了 HubSpot 爬虫。与网站管理员或团队中的开发人员合作，确保 IP 范围 54.174.58.224/27 未被阻止。
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 配置。
如何解决
- 访问 URL，确保页面加载正常。
- 如果浏览器显示证书错误，请与网站管理员或开发人员合作，更新或正确配置网站的SSL/TLS 安全证书 和设置。
