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

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

上次更新時間: 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 的協助。