설명서Experience Cloud KCS

작성자의 업데이트 후 AEM 미리보기 환경에 오퍼 구성 요소 누락

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

Adobe Experience Manager(AEM)에서 작성자에서 추가하거나 업데이트하는 오퍼 구성 요소가 미리보기 환경에 표시되지 않습니다. 이 문제는 종종 특정 페이지에 영향을 미치지만 다른 페이지에는 업데이트된 콘텐츠가 예상대로 계속 표시됩니다. 오류 메시지는 표시되지 않지만 미리보기에 누락되었거나 오래된 오퍼 구성 요소가 표시되어 게시 전 콘텐츠 유효성 검사에 영향을 줍니다. 이 문제를 해결하려면 페이지 콘텐츠와 API 응답을 확인하고, 미리보기 또는 프론트엔드 백엔드를 확인한 다음 영향을 받는 페이지를 다시 게시합니다.

설명 description

환경

  • Adobe Experience Manager(AEM), 모든 버전
  • 분리된/Headless 미리보기 환경(예: AEM API를 사용하는 사용자 정의 프론트엔드 애플리케이션)

문제/증상

  • 업데이트되거나 새로운 오퍼 구성 요소는 AEM 작성자에 표시되지만 미리보기 환경에는 표시되지 않습니다.
  • 다른 페이지는 예상대로 업데이트될 수 있습니다. 이 문제는 특정 페이지에만 해당됩니다.
  • 명시적인 오류 메시지가 표시되지 않습니다.

원인

가장 일반적인 원인은 미리보기 환경 또는 BFF(Backend-for-Frontend) 계층에 캐싱을 수행하는 것입니다. 일반적으로 AEM 작성자 또는 게시 복제 문제가 아닙니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. 의도한 모든 오퍼 구성 요소가 AEM 작성자 환경에 존재하고 게시되어 있는지 확인합니다.
  2. CRX/DE 또는 AEM Sites 콘솔을 사용하여 영향을 받는 페이지의 jcr:content 노드에 올바른 구성 요소가 포함되어 있는지 확인하십시오.
  3. 미리보기 애플리케이션이 콘텐츠를 가져오는 데 사용하는 API 엔드포인트를 식별합니다. 이 끝점은 대개 사용자 지정 또는 Headless 끝점입니다. 확실하지 않은 경우 프론트엔드 또는 백엔드 팀에 문의하십시오.
  4. 브라우저 또는 API 도구를 사용하여 직접 끝점에 액세스하고 JSON 응답에 모든 예상 오퍼 구성 요소가 포함되어 있는지 확인합니다.
  5. 미리보기 환경 또는 백엔드에 대한 프론트엔드 레이어가 API 응답을 캐시하는지 여부를 결정합니다. 캐시를 지우거나 캐시 TTL(Time-to-Live)을 줄여 새로운 콘텐츠를 가져옵니다. 구현에 사용자 지정 캐시 무효화 논리가 포함되어 있는 경우 논리가 활성화되어 있고 작동하는지 확인하십시오.
  6. 텍스트 편집 또는 구성 요소 재정렬 등 작성자의 영향을 받는 페이지를 약간만 변경할 수 있습니다. 미리보기 환경에서 업데이트를 표시할 때 변경 시간 및 모니터에 주목합니다.
  7. AEM 및 Preview 또는 Backend-for-Frontend 로그를 검토하여 변경 전파를 추적합니다.
  8. 문제가 지속되면 페이지 또는 jcr:content 노드를 업데이트하고 다시 게시하여 새로 고침합니다.
  9. 프론트엔드 또는 백엔드 팀에 문의하여 통합 및 캐싱 논리를 검토하십시오. 미리보기 애플리케이션이 올바른 AEM 끝점을 호출하고 캐시에서 오래된 콘텐츠를 제공하지 않는지 확인합니다.
  10. 모든 오퍼 구성 요소가 나타나고 미리보기 환경에 현재 콘텐츠가 표시되는지 확인합니다.

관련 읽기

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