文档Experience Cloud KCS

Adobe Experience Manager：修复由于缺少Dispatcher路径映射而损坏的导航和资产链接

最近更新： 2026年7月24日

本文介绍了当Dispatcher路径映射在维护或刷新Dispatcher缓存后缺失或不完整时，如何在Adobe Experience Manager (AEM)站点中解决导航和资产链接中断的问题。

描述 description

环境

Adobe Experience Manager Sites (AEM Sites)，所有受支持的版本和使用Dispatcher模块的部署模型

症状

在定期维护或Dispatcher缓存刷新后，网站中的导航链接和图像资产路径将会损坏。 受影响的链接输出URL以/content/<site-context>/...（有效）或/<site-context>/...（无效）开头。 在出现问题之前，这些路径模式都不会出现在链接路径中。 此问题还会影响图像路径，导致整个站点的图像损坏。

原因

站点上下文的Dispatcher路径映射缺失或不完整，导致生成的URL无法正确解析。 此配置间隙通常在Dispatcher缓存清除或维护活动后出现，导致未映射的URL以及链接和资产断开。

解决方法 resolution

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

  1. 查看Dispatcher配置文件，查找与网站上下文路径相关的缺失路径映射。

  2. 检查映射文件（如aem-base-uris.txt或等效项）以确保站点上下文存在所有必需的映射。

  3. 在调度程序配置中添加从/<site-context>到/content/<site-context>的映射。 例如：

    /<site-context> /content/<site-context>

  4. 如果需要，请将Dispatcher 301重定向配置为规范虚名URL，以确保一致的URL分辨率。

  5. 更新配置后，清除Dispatcher缓存以应用更改。

  6. 验证导航链接和图像资产路径现在能否在网站上正确解析。

  7. 如果在维护期间暂停了复制代理，请恢复其操作。

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