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

檢視並排除客戶服務專員內容來源同步錯誤

上次更新時間: 2026年8月18日

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

在將內容來源與客戶代理程式同步時,您可能會遇到錯誤。請參閱以下內容,了解如何檢視內容來源的同步狀態,並排除常見錯誤,以確保您的客戶代理程式使用的是最新內容。 

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

在排除特定錯誤之前,請先檢查已新增內容來源的同步狀態:

  1. 在你的 HubSpot 帳戶中,點擊「更多」,然後前往「服務」 > 「客戶代理程式」。如果你的帳戶中沒有顯示「更多」,請直接前往「服務」 > 「客戶代理程式」
  2. 在左側邊欄選單中,點選「訓練」>「知識庫」。 
  3. 在表格的右上角,點選「失敗 分頁 。 
  4. 在表格中,檢視未能成功同步的特定內容來源及其相關的錯誤訊息。

customer-agent-error-messages

了解並排除內容來源錯誤

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

錯誤的含義

無法取得內容。此情況可能發生於 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 位址清單

此內容無法同步,因為其網址缺少

錯誤說明

HubSpot 頁面(網站、著陸頁、部落格文章等)需要有效的網址,系統才能載入這些頁面。所連結的網址為空白或無效。

如何解決此錯誤

依照本文中的步驟更新 HubSpot 內容的網址,然後再次嘗試新增該內容

該網站發生伺服器問題,可能是由於系統停機或安全政策所致

錯誤說明 

伺服器傳回一般性錯誤(500 或 503)。這通常表示網站暫時無法存取,或是伺服器正在主動封鎖 HubSpot 爬蟲程式。

如何解決此錯誤 

  • 請造訪該網址,確認頁面能否正常載入。 
  • 若頁面能正常載入,則表示網站可能正在封鎖 HubSpot 爬蟲。請與您的網站管理員或團隊中的開發人員合作,確保 IP 範圍 54.174.58.224/27 未被封鎖。您也可以使用 IP 範圍 API擷取 HubSpot 所使用的最新 IP 位址清單。

HubSpot 內容尚未發佈,因此無法同步

錯誤說明

您嘗試新增的 HubSpot 託管內容目前處於草稿狀態,尚未發佈。

如何解決此錯誤

請先發佈該頁面,然後嘗試新增內容。若您不希望讓內容對外公開,請進一步了解如何將內容設為私有

因內容政策導致內容無法同步

錯誤說明 

HubSpot 無法索引該內容,因為該內容可能違反HubSpot 服務條款《可接受使用政策》

如何解決此錯誤 

內容參考無效 

錯誤說明

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 安全憑證及 相關設定。
這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助