疑難排解Experience Modernization Agent troubleshooting

找出症狀,然後追蹤其章節。 大多數問題都來自對來源網站的存取、將程式碼和內容寫入您的Adobe Experience Manager Edge Delivery Services網站的帳戶,或您的主控台工作區與Git和內容來源中的儲存內容之間的差異。

症狀
區段
匯入失敗,或擷取的頁面顯示錯誤或登入頁面。
匯入失敗
探索後遺失URL,或來源網站傳回HTTP 403、429或503。
具有機器人保護的Source網站
您所做的變更不會顯示。
遺漏變更
主控台預覽不符合預覽網站。
主控台預覽與站台不同
上傳、提取或傳輸失敗。
內容寫入失敗
控制檯不會列出您的存放庫,或無法推送至該存放庫。
Git連線問題
主控台會持續準備您的工作區。
Workspace安裝需要時間或失敗
您的專案在您登入後即不存在。
專案似乎遺失
無法傳送訊息。 請再試一次。
無法傳送訊息
您必須移除匯入的頁面。
移除頁面

在您重設、捨棄、取代或覆寫任何內容之前,請保留受影響的工作。 程式碼和內容會分別復原;請參閱發行、復原和移交。

如果此頁面無法解決問題,請在主控台中要求支援,或在[自動模式]頁面上選取​取得說明。

匯入失敗 import-fails

保留錯誤和確切的來源URL,並檢查URL是否會在瀏覽器中開啟。 如果頁面需要登入,或擷取顯示的是登入頁面而非內容,請設定受保護的網站驗證。 如果來源網站封鎖自動存取,請參閱具有機器人保護的Source網站。 如果來源可以連線,請將錯誤提供給代理程式,並要求它修正該頁面的匯入。 在重複批次之前,請重試一個受影響的頁面。

具有機器人保護的Source Sites bot-protection

內容傳遞網路(CDN)或網頁應用程式防火牆(WAF)中的機器人保護可在每個工作流程中封鎖或挑戰代理程式對來源網站的請求:URL探索、網站目錄、頁面擷取及匯入。 典型的標誌是拒絕存取的錯誤,例如HTTP 403、429或503、探索後遺失URL、失敗的頁面,或是擷取的詢問或驗證頁面而不是頁面內容。

僅移轉您擁有或有權移轉的網站。 安排與網站管理員的存取權,而非解決保護問題:

  1. 要求管理員允許移轉期間的存取,例如在CDN或WAF中允許列出後端位址。
  2. 如果保護接受認證(例如機密要求標頭),請在工作流程提供的驗證控制項中輸入它,例如主控台設定中的受保護的網站驗證。 使用限定範圍的認證,並在移轉完成時將其移除。
  3. 如果管理員提供具有相同內容的可存取暫存或來源主機,請將其用作來源並記錄託管內容的來源。
  4. 如果只有探索遭到封鎖,請提供要移轉的頁面URL清單。

開始目錄或批次執行之前,請先核取一個頁面,包括其影像和其他資產。 存取變更後,請重試失敗的頁面,並在您接受內容之前,先檢查擷取是否有挑戰或拒絕存取的頁面。

允許清單IP位址 allowlist-ip-addresses

取得來源網站管理員的核准後,將下列後端地址加入來源擷取的允許清單:

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

允許清單僅提供網路存取:來源仍必須可透過網際網路連線,且受保護頁面仍需要受保護的網站驗證。

缺少變更 missing-change

程式碼和內容會儲存在不同的位置,因此請檢查每個位置:主控台工作區、上傳的內容、推播分支和預覽頁面。 重新匯入會覆寫本機內容變更,因此在再次匯入頁面之前,請先上傳或調解編輯。 若要比較主控台預覽與預覽網站,請參閱主控台預覽與網站不同。

主控台預覽與網站不同 preview-differs

主控台預覽和預覽網站會呈現不同的內容與程式碼復本,如知道您正在檢視哪個結果所述。 尋找下列其中一個原因:

  • 未上傳的內容:​在主控台中變更的頁面尚未在Experience Workspace中上傳。 透過​同步 > 推播 > 內容​上傳這些內容。
  • 在其他地方編輯的內容:​在Experience Workspace中變更的頁面尚未在主控台工作區中。 以​同步 > 提取 > 內容​提取這些頁面,這會覆寫對這些頁面的本機編輯;重新整理​只會重新載入轉譯。
  • 不同的程式碼:​不是推送程式碼,或是預覽URL使用其他分支。 推送程式碼,並開啟具有程式碼的分行的預覽URL。
  • 不同的寬度:​預設情況下,主控台預覽會填滿面板。 使用​檢視區​功能表,以相同寬度比較。
  • 預覽網站移除的標示: Edge Delivery Services只會保留區段、區塊和預設內容,因此頁面標示內的樣式會遺失。 要求代理程式將其移至專案的CSS。 檢視預覽的運作方式。

內容寫入失敗 write-errors

程式碼和內容使用不同的帳戶。 系統會使用您的GitHub連線或其他Git主機的Cloud Manager連線推送程式碼。 內容會以您登入的Adobe帳戶寫入Experience Workspace。 因此,程式碼推送可以在內容上傳失敗時成功,反之亦然。

如果上傳、提取或傳輸指出您的檔案製作工作階段可能已過期,請重新登入並重試。 當工作階段有效時,主控台會顯示相同的訊息,但您的Adobe帳戶沒有網站內容的寫入許可權。 如果持續發生,請要求網站管理員確認您的帳戶(連同您在主控台中使用的電子郵件地址和組織)可以寫入Experience Workspace的網站。 在Adobe Admin Console中存取Experience Manager本身不會授予網站內容的寫入許可權。 如果主控台指出您的速率受限,請稍候片刻,然後再試一次。

Git連線問題 git-connection

如需每個GitHub應用程式的作用,請參閱從存放庫啟動。

問題
該做什麼
您的組織或存放庫未列出。
組織或帳戶中缺少AEM程式碼聯結器應用程式、僅涵蓋其他選取的存放庫,或等待組織擁有者的核准。 依照從存放庫開始中的說明新增它。 使用個人存取權杖時,主控台僅列出您可以推送到的存放庫。
您沒有​存放庫的寫入許可權。
連線需要推送存取權。 要求存放庫管理員提供寫入許可權,或連線其他存放庫。
主控台無法驗證預覽URL。
如果存放庫中沒有「AEM程式碼同步」,網站就沒有預覽URL。 檢查應用程式是否存在,以及URL是否遵循模式https://{branch}--{site}--{organization}.aem.page。
在安裝AEM Code Connector應用程式前會停用推送,或需要​AEM Code Connector。
主控台可以讀取存放庫,但不能寫入存放庫: AEM Code Sync可讓Edge Delivery Services讀取您的程式碼,只有AEM Code Connector可讓主控台變更您的程式碼。 將AEM程式碼聯結器新增至存放庫。
無效或過期的Token,或該Token缺少使用者讀取許可權。
建立新的Token。 使用傳統權杖或可讀取您的使用者帳戶並寫入存放庫內容的精細權杖。
允許LLM使用我的Git認證​不在[設定]中。
您尚無法使用此設定。 代理程式仍然可以在主控台工作區中變更程式碼;使用​同步 > 推送 > 程式碼​自行推送。
拒絕推送:您需要Cloud Manager​中的部署管理員角色。
對於透過Cloud Manager連線的存放庫,請向您的管理員要求Cloud Manager中的部署管理員角色。

如需發生衝突的變更與受保護的分支,請參閱推送程式碼變更。

Workspace安裝需要一些時間或失敗 workspace-setup

準備工作區最多需要10分鐘,包括第一次登入和重設後。 如果所有工作區都在使用中,主控台會通知您,並在其中一個工作區可用時立即開始設定您的工作區;您不需要重試。 若您更早需要支援,請選取​要求支援。 如果安裝失敗,主控台會提供重試。 如果持續失敗,請使用安裝程式畫面上的​ 要求支援 ​連結。 如果主控台指出您的帳戶無法使用它,請聯絡您的Adobe帳戶團隊。 如需顯示​ 您的工作區已暫停 ​的工作區,請參閱開啟體驗現代化主控台。

專案似乎已遺失 missing-workspace

如果您屬於多個Adobe組織,則專案可能位於其他組織的主控台工作區。 登出,然後使用相同的帳戶登入,並選擇您之前使用的組織設定檔。 調查時請勿重設工作區:重設會刪除您尚未推播的工作。 如果專案仍然遺失,請使用專案名稱和預覽URL 要求支援。 無論採取何種方式,推播程式碼和上傳的內容在Git存放庫和內容來源中都是安全的。

無法傳送訊息 send-failed

無法傳送訊息。 請再試一次。 表示主控台無法將您的提示傳送給代理程式。 此訊息未提供原因,可能是您的網路連線、登入過期或暫時服務問題。

  1. 請檢查您的網路連線,然後再次傳送提示。 主控台不會自動重試。
  2. 如果再次失敗,請複製您的提示,重新載入頁面,並在詢問時登入。 您的聊天記錄會保留。
  3. 如果幾分鐘後仍然失敗,請在設定中使用​要求支援,並附上失敗時間和您的專案名稱。

如果主控台指出它已經達到容量,請參閱Workspace安裝需要時間或失敗。

移除頁面 remove-pages

主控台中的安全保護可阻止代理程式刪除專案內容資料夾中的檔案,因此移轉的內容不會錯誤地移除。 因此要求代理程式刪除頁面無法運作。 自行將他們移除,將其放置於每個位置:

  • 主控台工作區:​在內容檢視中,選取頁面並一次使用一個頁面​刪除。 這只會移除主控台工作區副本。
  • 內容來源:​刪除Experience Workspace中或作者執行個體上已上傳的頁面。 在此之前,您在主控台中刪除的頁面會以雲端圖示重新出現在內容檢視中。
  • 預覽和即時網站:​使用AEM Sidekick取消發佈或刪除預覽和發佈的頁面。

如果頁面匯入到錯誤的路徑,請再次將它們匯入到正確的路徑,檢查它們,然後刪除錯誤路徑的副本。

recommendation-more-help
experience-manager-cloud-service-help-main-toc