文档Experience Cloud KCS

DITA-OT/Saxon升级后AEM Guides中输出生成失败的疑难解答

最近更新： 2026年8月28日

在Adobe Experience Manager (AEM) Guides中，升级自定义DITA-OT/Saxon包后，即使源内容和配置保持不变，输出生成作业也会间歇性地失败。 该问题包括重复的document-URI错误以及与输出生成期间缺少依赖项相关的初始化失败。 要解决此问题，请更新DITA-OT配置，验证所需的依赖关系，然后重新加载受影响的DITA配置文件配置。

描述 description

环境

带有自定义DITA-OT/Saxon包的Adobe Experience Manager Guides（所有版本；在DITA-OT/Saxon升级后发现的问题）

问题/症状

  • 输出生成作业间歇性失败。
  • 初始化失败：在DITA-OT启动期间加载org/slf4j/Logger时出错。
  • 转换失败：引用subjectScheme.ditamap时出现重复的document-URI错误。
  • 对于相同的配置和内容，运行成功和失败。

原因

  • 重复的document-URI错误可能是由于升级的DITA-OT/Saxon版本引入的更严格的验证或URI处理，导致多次解析同一主题方案文档。
  • org/slf4j/Logger初始化失败指向更新的自定义DITA-OT包中缺少依赖项、包不完整或类路径配置错误。
  • 通过代码进行部署可能不会触发必要的内存中配置文件同步，需要手动保存以重新加载配置。

解决方法 resolution

请按照以下步骤解决问题：

  1. 将subjectScheme.ditamap添加到DITA-OT/Saxon配置的重复映射扫描排除列表中。 应用更改后，验证输出生成是否按预期工作，并查看结果以找出任何意外的副作用。
  2. 验证部署到AEM的自定义DITA-OT包中是否存在所有必需的SLF4J依赖项和JAR文件。
  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