跳到內容
請注意：：這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立，可能沒有經過校對。因此，這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

檢閱客戶代理內容來源同步錯誤，並排除故障

上次更新時間： 2025年11月26日

可搭配下列任何訂閱使用，除非另有註明：

與客戶代理同步內容來源時，可能會遇到錯誤。以下將介紹如何檢視內容來源的同步狀態，並排除常見錯誤，以確保您的客戶代理使用最新的內容。

檢視新增至客戶代理的內容來源的同步狀態

在排除特定錯誤之前，請檢查所有新增內容來源的同步狀態：

  1. 在你的 HubSpot 帳戶中，瀏覽「服務」>「客戶代理程式」。 檢視新增至客戶代理的內容來源的同步狀態。
  2. 導覽至「 管理」 索引標籤。
  3. 在左側功能表中，按一下 內容來源。
  4. 在表格右上方，按一下失敗 索引標籤。
  5. 在表格中，檢視同步失敗的特定內容來源及其相關的錯誤訊息。

customer-agent-error-messages

瞭解內容來源錯誤並排除故障

知識來源不再存在或無法存取

錯誤的意義

無法擷取內容。如果 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" meta 標籤。

該頁面無法載入，因為它是私人或封鎖的頁面

錯誤的意思

爬行器收到 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 安全證書 和設定。
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。
目錄

相關內容

New call-to-action