설명서Experience Cloud KCS

깊게 중첩된 콘텐츠 조각이 있는 페이지 게시

마지막 업데이트: 2026년 8월 1일

이 문서에서는 재귀 참조 검색 프로세스 동안 시간 초과로 인해 깊게 중첩된 콘텐츠 조각을 참조하는 AEM Sites 페이지를 게시하지 못하는 상황을 해결하는 방법에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (모든 버전)

문제/증상

딥링크 또는 광역 중첩 참조가 있는 콘텐츠 조각을 참조하는 AEM Sites 페이지를 게시할 때 이 페이지는 게시 관리 페이로드에 표시되지 않고 게시되지 않습니다. 이 문제는 콘텐츠 조각이 다른 많은 콘텐츠 조각을 참조하여 수천 개의 중첩된 참조와 여러 수준의 중첩을 초래할 때 발생합니다. 참조 확인 프로세스가 느려지고 시간이 초과되어 페이지가 게시 워크플로우에 포함되지 않을 수 있습니다. UI에 명시적인 오류 메시지가 표시되지 않지만 예상 페이지가 게시 페이로드에서 누락되었습니다.

원인

깊게 중첩된 콘텐츠 조각에 대한 재귀 참조 검색으로 인해 성능 저하 및 시간 초과가 발생하여 페이지가 게시 페이로드에 포함되지 않을 수 있습니다. 반복 검색을 비활성화하면 성능이 향상되지만 중첩된 조각 게시를 수동으로 관리해야 합니다.

해결 방법 resolution

깊게 중첩된 콘텐츠 조각을 참조하는 AEM Sites 페이지를 게시하지 못하는 문제를 해결하려면 다음 단계를 수행합니다.

  1. com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl에 대한 구성을 업데이트하고 재귀 콘텐츠 조각 참조 검색을 사용하지 않도록 설정하는 옵션을 설정하여 재귀 콘텐츠 조각 참조 검색을 사용하지 않도록 설정합니다.

  2. Cloud Manager을 통해 구성 업데이트:

    • Cloud Manager 프로젝트에서 com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl에 대한 OSGi 구성 파일을 추가하거나 업데이트합니다.
    • 구성에서 "enable.recursive.cf.reference.search": false을(를) 설정합니다.
    • Cloud Manager 파이프라인을 통해 구성을 커밋하고 배포합니다.

  3. 또는 로컬 또는 비프로덕션 환경에서 OSGi 콘솔을 통해 구성을 업데이트합니다.

    • AEM 작성자 인스턴스에 로그인합니다.
    • /system/console/configMgr(으)로 이동합니다.
    • ActivationReferenceSearchServiceImpl 검색
    • 구성을 편집하고 재귀 콘텐츠 조각 참조 검색을 false(으)로 설정합니다.
    • 구성을 저장합니다.

  4. 재귀 검색을 비활성화한 후 게시 관리를 사용하여 영향을 받는 페이지를 다시 게시하려고 합니다. 이제 페이지가 게시 페이로드에 포함되어 성공적으로 게시되어야 합니다.

  5. 필요에 따라 깊이 중첩된 콘텐츠 조각을 수동으로 게시합니다. 순환 검색이 비활성화되면 첫 번째 수준 참조만 자동으로 확인됩니다. CF/Assets 콘솔을 통해 중첩된 콘텐츠 조각을 수동으로 게시하거나 게시 프로세스에 관련 CF 폴더를 포함하여 필요한 모든 중첩된 콘텐츠 조각이 게시되는지 확인합니다.

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