설명서Experience Cloud KCS

Adobe Experience Manager에서 SegmentNotFoundException 오류 해결

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

이 문서에서는 백업에서 복원하고, 저장소 상태를 확인하고, 유지 관리를 수행하여 Adobe Experience Manager(AEM)의 SegmentNotFoundException 오류를 해결하는 방법에 대해 설명합니다.

설명 description

Adobe Experience Manager의 SegmentNotFoundException 오류는 저장소 손상 또는 세그먼트 누락을 나타내며, 이로 인해 AEM 작성 환경에 액세스할 수 없게 되고 일반 작업이 중단될 수 있습니다. 이러한 오류는 일반적으로 반복되는 로그 항목과 AEM 작성자 인스턴스에 액세스할 수 없는 것으로 표시됩니다. 마지막으로 알려진 백업에서 복원하고 저장소 상태를 확인하는 것은 환경을 복구하고 추가 문제를 방지하는 중요한 단계입니다.

환경

Adobe Experience Manager(AEM) Managed Services(모든 버전)

증상

  • AEM 로그에서 SegmentNotFoundException 오류
  • AEM 작성자 환경에 액세스하거나 사용할 수 없음
  • 마지막으로 알려진 작업 백업 복원 요청

원인

SegmentNotFoundException 오류는 일반적으로 저장소 손상 또는 누락된 세그먼트로 인해 발생하며, 문제를 해결하고 재발을 방지하기 위해 백업 및 저장소 압축을 통한 복원이 필요한 경우가 많습니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 저장소, 데이터 저장소 및 인덱스와 같이 필요한 모든 파일이 포함되어 있는지 확인하여 AEM 환경의 가장 최근 유효한 백업을 식별합니다.

  2. 조직의 백업 및 복원 절차에 따라 AEM 환경에 백업을 복원합니다. 모든 구성 요소(저장소, 데이터 저장소, 인덱스)가 올바른 위치로 복원되었는지 확인합니다.

  3. 복원 후에는 저장소, 데이터 저장소 및 인덱스 일관성 검사를 실행하여 복원된 환경의 무결성을 확인합니다. 색인 일관성 검사를 위해 환경에 적합한 매개 변수와 함께 Oak 실행 도구를 사용합니다. 명령 예:

    java -jar oak-run.jar index --index-consistency-check <datastore-config-path> <segmentstore-path>

    <datastore-config-path> 및 <segmentstore-path>을(를) 환경에 맞는 경로로 바꾸십시오.

  4. 일관성 검사 결과를 검토하여 모든 인덱스가 유효한 것으로 보고되도록 합니다.

  5. 저장소를 최적화하고 추가 세그먼트 문제를 방지하기 위해 저장소의 오프라인 압축을 수행합니다. 정기적인 오프라인 압축을 예약하고 온라인 압축을 비활성화하여 세그먼트 손상 위험을 줄입니다.

  6. SegmentNotFoundException 오류의 반복에 대해 환경을 모니터링합니다. 문제가 재발하면 세그먼트 손상에 기여할 수 있는 오래 실행되는 워크플로우 또는 프로세스에 대한 로그를 검토하십시오.

  7. (선택 사항) 추가 분석을 위해 힙 또는 스레드 덤프를 캡처하려면 조직의 절차에 따라 AEM 프로세스에서 jstack 또는 jmap과(와) 같은 표준 Java 도구를 사용합니다.

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