설명서Experience Cloud KCS

사용자 지정 회전 메뉴 구성 요소의 페이지 형식이 잘못되어 AEM Author 미리보기 404 오류가 발생했습니다

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

이 문서에서는 사용자 지정 슬라이드 구성 요소가 형식이 잘못되었거나 빈 페이지를 참조하여 렌더링 오류가 발생할 때 Adobe Experience Manager(AEM) 작성자 미리 보기에서 404 오류를 해결하는 방법에 대해 설명합니다.

설명 description

환경

  • Adobe Experience Manager(AEM) 작성자
  • Sling 모델을 사용한 맞춤형 슬라이드 구성 요소

문제/증상

  • 사용자 지정 회전 메뉴 구성 요소를 포함하는 AEM Author의 페이지를 미리 보면 404 오류가 발생합니다.
  • 캐러셀이 형식이 잘못되었거나 빈 페이지를 참조할 때 오류가 발생합니다.

원인

슬라이드 구성 요소에서 사용하는 사용자 지정 슬링 모델의 NullPointerException(으)로 인해 문제가 발생합니다. 모델이 누락되거나 잘못된 페이지를 처리하지 않습니다. 참조된 페이지에 예상 경로 아래에 하위 노드 또는 컨텐츠가 없는 경우 구성 요소가 렌더링에 실패하고 404 응답을 반환합니다.

해결 방법 resolution

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

  1. AEM 사이트의 사용자 지정 슬라이드 구성 요소에서 참조하는 페이지 목록을 검토합니다.
  2. 예상 경로에서 필요한 컨텐츠가 비어 있거나 형식이 잘못되었거나 누락된 페이지를 식별합니다.
  3. 저장소에서 유효하지 않거나 비어 있는 페이지를 제거하거나 수정합니다.
  4. 사용자 지정 회전 메뉴 구성 요소 코드를 업데이트하여 누락되거나 잘못된 페이지를 정상적으로 처리합니다.
  5. 구성 요소가 오류를 일으키지 않고 잘못된 항목을 건너뜁니다.
  6. AEM 작성자 미리 보기에서 영향을 받는 페이지를 테스트하여 404 오류가 더 이상 발생하지 않고 회전판이 예상대로 렌더링되는지 확인하십시오.
recommendation-more-help
experience-cloud-kcs-help-kbarticles