설명서Experience Cloud KCS

게시 인스턴스의 AEM 외부 링크 검사기 구성 문제

마지막 업데이트: 2026년 6월 21일

게시의 외부 링크 검사기는 반복된 경고를 트리거하고, 유효한 외부 링크를 제거하고, 게시된 페이지의 성능 문제에 기여할 수 있습니다. 이 문제는 서비스가 게시 시 외부 URL의 유효성을 검사하거나, 저장 용량 제한을 초과하거나, 잘못된 것으로 표시한 링크를 다시 작성할 때 발생합니다. 영향을 받는 환경에서는 비헤이비어가 게시로 제한되고 작성자에게 표시되지 않습니다. 해결 방법은 게시에서 링크 검사기 구성을 비활성화 또는 조정하고, 경고가 중단되고 링크가 제대로 작동하는지 확인하는 것입니다.

설명 description

환경:

  • Adobe Experience Manager as a Cloud Service
  • Adobe Experience Manager Managed Services
  • Adobe Experience Manager 온프레미스 소프트웨어
  • 인스턴스 게시

문제/증상:

  • 게시 로그에서 com.day.cq.rewriter.linkchecker.impl.LinkInfoStorageImpl의 반복된 경고를 검토하십시오.
  • 로그에 호스트의 외부 링크가 호스트당 구성된 최대 수에 도달했는지 여부를 확인합니다.
  • 게시된 페이지의 외부 링크가 짧게 표시되었다가 게시 후 클릭할 수 없는지 확인합니다.
  • 게시 성능 문제 또는 불안정성이 링크 검사기 활동과 일치하는지 확인합니다.
  • 작성자에게 동일한 경고와 증상이 나타나지 않는지 확인하십시오.

근본 원인:

링크 검사기는 명시적으로 비활성화되지 않은 경우 게시 시 실행됩니다. 외부 URL에 대한 구문 및 가용성 검사를 수행하며 대량의 외부 또는 동적 링크가 호스트당 기본 스토리지 제한을 초과할 수 있습니다. 유효성 검사기가 링크를 유효하지 않은 것으로 표시하면 변환기가 게시 시 해당 링크를 제거하거나 다시 작성할 수 있습니다.

해결 방법 resolution

다음 단계를 수행하십시오.

  1. 이 문제가 반복된 저장소 제한 경고, 게시 페이지에서 제거되는 외부 링크 또는 광범위한 게시 성능 문제로 인해 발생하는지 여부를 결정합니다.
  2. 저장소 제한 경고와 관련된 문제인 경우 com.day.cq.rewriter.linkchecker.LinkInfoStorage에 대한 구성을 검토하고 필요에 따라 service.max_links_per_host을(를) 조정하거나 게시할 때 서비스를 사용하지 않도록 설정하십시오.
  3. 외부 링크가 제거되는 경우 링크 검사기 변환기 구성을 업데이트하고 검사 사용 안 함 및/또는 다시 쓰기 사용 안 함을 true(으)로 설정합니다.
  4. 링크 검사기 활동이 게시측 불안정성을 유발하는 경우 검사 비활성화 및 다시 작성 비활성화를 모두 켜서 게시에서 링크 검사기를 비활성화하십시오.
  5. 클라우드 환경에서 게시 실행 모드 OSGi 구성을 배포하거나 관리 또는 온프레미스 환경을 위한 OSGi 콘솔에서 직접 구성을 저장하여 구성을 적용합니다.
  6. 영향을 받는 콘텐츠를 다시 게시하고 외부 링크가 클릭 가능한 상태로 유지되며 새 링크 검사기 경고가 게시 로그에 더 이상 표시되지 않는지 확인하십시오.
  7. 게시 로그를 모니터링하여 경고가 반환되지 않고 페이지 동작이 안정적으로 유지되는지 확인하십시오.

구성을 변경한 후에도 경고가 계속되거나, 게시 시 링크가 여전히 제거되거나, 확인 후에도 게시 성능에 영향을 주는 경우 Adobe 지원에 티켓을 제출하십시오.

관련 읽기

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