설명서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. Dispatcher 구성에서 /<site-context>에서 /content/<site-context>(으)로의 매핑을 추가합니다. 예:

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

  4. 필요한 경우, 일관된 URL 확인을 보장하기 위해 표준 vanity URL로 Dispatcher 301 리디렉션을 구성합니다.

  5. 구성을 업데이트한 후 변경 사항을 적용하려면 Dispatcher 캐시를 지우십시오.

  6. 이제 사이트에서 탐색 링크 및 이미지 자산 경로가 올바르게 확인되는지 확인합니다.

  7. 유지 관리 중에 복제 에이전트가 일시 중지된 경우 작업을 다시 시작합니다.

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