文件Experience Cloud KCS

疑難排解DITA-OT/Saxon升級後AEM Guides中的輸出產生失敗

最後更新： 2026年8月30日

在Adobe Experience Manager (AEM) Guides中，升級自訂DITA-OT/Saxon套件後，輸出產生作業會斷斷續續地失敗，即使來源內容和設定維持不變。 該問題包括重複的檔案URI錯誤以及與輸出產生期間缺少相依性相關的初始化失敗。 若要修正此問題，請更新DITA-OT組態、驗證必要的相依性，並重新載入受影響的DITA設定檔組態。

說明 description

環境

Adobe Experience Manager Guides搭配自訂DITA-OT/Saxon套件（所有版本；DITA-OT/Saxon升級後發現的問題）

問題/症狀

  • 輸出產生工作會斷斷續續地失敗。
  • 初始化失敗：在DITA-OT啟動期間載入org/slf4j/Logger時發生錯誤。
  • 轉換失敗：參考subjectScheme.ditamap時出現重複的document-URI錯誤。
  • 成功和失敗的執行會以相同的設定和內容發生。

原因

  • 重複的檔案URI錯誤可能是因為升級的DITA-OT/Saxon版本引進了更嚴格的驗證或URI處理，導致同一個主題配置檔案被多次解析。
  • org/slf4j/Logger初始化失敗指向更新的自訂DITA-OT套件中遺漏的相依性、不完整的套件或類別路徑錯誤設定。
  • 透過程式碼進行的部署可能不會觸發必要的記憶體內設定檔同步處理，而需要手動儲存以重新載入設定。

解決方法 resolution

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

  1. 將subjectScheme.ditamap新增至您的DITA-OT/Saxon組態中的重複對應掃描排除清單。 套用變更後，驗證輸出產生是否如預期般運作，並檢閱結果以找出任何非預期的副作用。
  2. 確認所有必要的SLF4J相依性和JAR檔案都存在於部署至AEM的自訂DITA-OT套件中。
  3. 請確定DITA-OT ZIP套件是完整的，並包含所有必要的程式庫。
  4. 檢閱DITA設定檔中的類別路徑組態，並確認它包含更新工具組的所有必要相依性。
  5. 如果透過程式碼或套件部署DITA設定檔，請在AEM Guides UI中開啟受影響的DITA設定檔、移除目前指派的路徑值、儲存設定檔、重新指派相同的路徑值，以及再次儲存設定檔，以手動重新載入設定。 請等候大約10到15分鐘，讓組態傳播。
  6. 重試輸出產生。
  7. 比較本機DITA-OT套件與部署至AEM的套件，並確認兩個套件一致。
  8. 如果問題仍然存在，請收集並檢閱失敗產生作業的錯誤記錄檔，以取得其他疑難排解。
  9. 執行輸出產生工作並驗證錯誤是否已不再發生，以及輸出是否已成功產生。

相關閱讀

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