文件Experience Cloud KCS

解決由Dispatcher和CDN快取造成的Dynamic Media智慧型裁切失敗

最後更新： 2026年7月16日

當Dispatcher快取或Dynamic Media CDN快取提供過時或封鎖的資源時，Dynamic Media智慧型裁切無法正確載入，或在AEM Assets和AEM Sites中顯示更新的裁切轉譯。 常見症狀包括智慧型裁切編輯器損毀、遺失裁切控點，以及裁切轉譯過時。 透過驗證Dispatcher快取和篩選規則、清除快取資源、使受影響的CDN內容失效和驗證智慧型裁切行為來解決問題。

說明 description

環境

  • Adobe Experience Manager動態媒體
  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Experience Manager Managed Services (AMS)
  • AEM 6.5搭配Dynamic Media智慧型裁切

問題/症狀

  • 智慧型裁切編輯器會顯示損毀的影像，而非編輯介面。
  • 智慧型裁切只會在新增略過快取的引數（例如?nocache=123）之後載入。
  • 在新增快取略過引數之前，更新的智慧型裁切轉譯不會出現在AEM Sites頁面上。
  • 裁切控點、調整控制項大小或預覽影像無法正確顯示。

原因

Dispatcher會在/libs/dam/gui/content/s7dam/smartcrop/*下快取或封鎖智慧型裁切編輯器資源，使編輯器無法正確載入。 Dynamic Media CDN快取也會在資產更新後提供過時的智慧型裁切轉譯，直到CDN快取重新整理為止。

解決方法 resolution

執行以下步驟以解決問題：

  1. 使用略過快取的查詢引數測試智慧型裁切編輯器，以判斷問題是否是由Dispatcher快取或Dynamic Media CDN快取所造成。
  2. 設定Dispatcher以從快取中排除智慧型裁切編輯器資源。 新增/libs/dam/gui/content/s7dam/smartcrop/*的快取拒絕規則。 確認Dispatcher不再從快取中提供這些資源。
  3. 請檢閱Dispatcher篩選規則，並確保明確允許智慧型裁切編輯器路徑。 確認智慧型裁切URL會傳回預期的內容，而非HTTP 403或404回應。
  4. 清除Dispatcher快取，移除過時的智慧型裁切編輯器HTML、JavaScript和相關資源。 重新載入智慧型裁切編輯器，並確認其可在沒有快取略過引數的情況下運作。
  5. 開啟資產並確認正確載入裁切控制點、調整控制項大小、預覽影像和編輯器元件，以驗證智慧型裁切功能。
  6. 如果更新的智慧型裁切轉譯在發佈後仍未出現，請調查Dynamic Media CDN快取。 重新發佈資產，並確認更新的轉譯是否無需查詢引數即可顯示。
  7. 透過CDN失效工作流程（或適用的API），讓受影響的Dynamic Media資產失效，然後重新載入受影響頁面，並確認已顯示更新的智慧型裁切轉譯。
  8. 如果資產間的智慧型裁切設定檔不一致，請開啟受影響的資料夾屬性，並儲存設定以重新整理資料夾中繼資料。 確認資料夾和所有資產繼承了正確的影像設定檔。

相關閱讀

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