文件Experience Cloud KCS

發佈執行個體上的AEM外部連結檢查器設定問題

最後更新： 2026年6月22日

發佈頁面上的外部連結檢查器可能會觸發重複警告、移除有效的外部連結，並導致發佈頁面上的效能問題。 當服務在發佈時驗證外部URL、超過其儲存空間限制，或將標籤為無效的連結重寫時，就會發生問題。 在受影響的環境中，行為僅限於發佈，不會顯示於作者。 解決方法是在發佈時停用或調整連結檢查器設定，並確認警告停止且連結仍正常運作。

說明 description

環境：

  • Adobe Experience Manager as a Cloud Service
  • Adobe Experience Manager Managed Services
  • Adobe Experience Manager內部部署軟體
  • 發佈執行個體

問題/症狀：

  • 檢閱發佈記錄檔以檢視com.day.cq.rewriter.linkchecker.impl.LinkInfoStorageImpl的重複警告。
  • 檢查記錄檔是否指出主機的外部連結已達到每個主機的最大設定數目。
  • 確認已發佈頁面上的外部連結是否短暫出現，然後在發佈後變成無法點按。
  • 確認發佈效能問題或不穩定是否顯示為與連結檢查器活動一致。
  • 確認作者上未出現相同的警告和症狀。

根本原因：

連結檢查器會在發佈時執行，除非它已明確停用。 它會執行外部URL的語法和可用性檢查，而大量外部或動態連結可能會超過每個主機的預設儲存限制。 當驗證器將連結標籤為無效時，轉換器可以在發佈時移除或重新寫入該連結。

解決方法 resolution

請嘗試下列步驟：

  1. 判斷問題是否起因於重複的儲存空間限制警告、從發佈頁面移除外部連結，或更廣泛的發佈效能問題。
  2. 如果問題與儲存限制警告有關，請檢閱com.day.cq.rewriter.linkchecker.LinkInfoStorage的設定，並視需要調整service.max_links_per_host或在發佈時停用服務。
  3. 如果正在移除外部連結，請更新連結檢查器轉換器設定，並設定 停用檢查 和/或 停用重新寫入 到true。
  4. 如果連結檢查器活動造成發佈端不穩定，請開啟 停用檢查 和停用重新寫入，以停用發佈時的連結檢查器。
  5. 在雲端環境中部署publish-runmode OSGi設定，或直接在受管理或內部部署環境的OSGi主控台中儲存設定，以套用設定。
  6. 重新發佈受影響的內容，並確認外部連結可點選，且新的連結檢查器警告不再出現在發佈記錄檔中。
  7. 監視發佈日誌，以確認警告未傳回且頁面行為保持穩定。

如果組態變更後警告仍持續存在，發佈時仍會移除連結，或驗證後發佈效能仍會受到影響，請將票證提交至Adobe支援。

相關閱讀

recommendation-more-help
experience-cloud-kcs-help-kbarticles