文件Experience Cloud KCS

AEM：在DEV/STAGE/PROD中進行DITA升級後，DAM資產預覽和編輯失敗

最後更新： 2026年7月17日

本文處理Adobe Experience Manager環境中DAM資產預覽和編輯功能的問題。

說明 description

環境


Adobe Experience Manager (AEM) （所有版本）

問題/症狀


在AEM Assets管理UI中，預覽某些影像（例如：按一下資產）可能會短暫地顯示資產，然後預覽會變成空白。 問題通常僅限於特定資產，而相同環境中的其他資產可能會繼續正常預覽。

受影響資產的瀏覽器網路追蹤會顯示失敗的Dynamic Media檢視器請求，類似：

GET /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse

請求會傳回：

HTTP 404
No preview server defined for root ID referenced in net path

相關的AEM記錄檔可能包含：

Unable to forward request for root [ content] , no preview servlet defined for [ content]

解決方法 resolution

請依照下列步驟解決問題：

  1. 檢查受影響資產的Dynamic Media中繼資料開啟資產中繼資料節點，並驗證下方的下列屬性：

    code language-none 
    /content/dam/<asset-path>/jcr:content/metadata

    具體檢查這些欄位：

    • dam:scene7FileStatus
    • dam:scene7File
    • dam:scene7ID
    • dam:scene7Domain
    • dam:scene7CloudConfigPath
    • dam:scene7APIServer
    • dam:scene7Type

    健康的資產通常應該具有：

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File已填入
    • dam:scene7ID已填入

  2. 與正在使用的資產比較如果可能的話，請將失敗的資產與相同環境中正確預覽的其他影像比較。 在大多數情況下，失敗的資產將遺失一或多個必要的dam:scene7*屬性，或者dam:scene7FileStatus將設定為非正常值，例如：

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. 重新上傳或重新處理受影響的資產重新上傳或重新處理資產會強制AEM/Dynamic Media重新產生遺失的Scene7連結中繼資料。 在驗證案例中，重新上傳已將資產從下列變更為其他變數：

    • dam:scene7FileStatus = NeedsReupload
    • 遺失dam:scene7File
    • 遺失dam:scene7ID

    變更為健全狀態，具有：

    • dam:scene7FileStatus = PublishComplete
    • 已填入dam:scene7File
    • 已填入dam:scene7ID

  4. 如果資產是由內容複製、封裝安裝或移轉所引進，請在目標環境中重新處理受影響的資產從其他環境複製的Assets可能會保留過時或不完整的動態媒體中繼資料，或略過目標環境中的正常動態媒體擷取。 在目標環境中重新上傳或重新處理會重新產生正確的本機dam:scene7*中繼資料。

  5. 重新上傳或重新處理之後，驗證預覽復原：

    • 確認資產預覽可在 資產詳細資料 中運作。
    • 確認資產不再發出失敗的預覽請求至：
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • 確認資產現在使用dam:scene7File中的有效Scene7控制代碼解析。

  6. 針對大量影響，請依狀態識別類似的資產如果多個資產受到影響，請查詢具有不健康的dam:scene7FileStatus值的資產，並重新處理該子集，而不是整個DAM樹狀結構。

原因

問題是由受影響的資產處於 不完整或過時的Dynamic Media同步處理狀態 所造成。 在此情況下，資產存在於AEM中，但缺少資產詳細資料預覽解析所需的有效Scene7連結中繼資料，例如dam:scene7File、dam:scene7ID或健康的dam:scene7FileStatus。

因此，資產詳細資料會嘗試使用/content/dam/...下的存放庫路徑而不是有效的Scene7資產控制代碼來載入Dynamic Media預覽，而預覽請求會失敗，導致預覽區域變為空白。

此狀態通常會在以下情況下引入：

  • Dynamic Media同步/上傳未完全完成。
  • 資產是從其他環境複製或移轉。
  • 從其他環境移轉過陳舊的dam:scene7*中繼資料。
  • 移轉或內容複製後，資產未在目標環境中完全重新處理。
recommendation-more-help
experience-cloud-kcs-help-kbarticles