설명서Experience Cloud KCS

사용자 지정 OSGi 구성 요소 오류로 인해 발생한 AEM Cloud Manager 배포 오류 해결

마지막 업데이트: 2026년 9월 3일

이 문서에서는 사용자 지정 OSGi 구성 요소가 인스턴스화되지 못해 불안정한 환경과 명확하지 않은 로그 메시지가 발생하는 경우 Adobe Experience Manager(AEM) Cloud Manager에서 배포 파이프라인 오류를 해결하고 해결하는 방법에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager(AEM) as a Cloud Service, Cloud Manager 파이프라인을 통해 배포됨

증상

  • 배포 파이프라인이 실패하고 새 배포가 안정적인 상태에 도달하지 않습니다.

  • 애플리케이션 인스턴스가 자주 재시작되고 준비되지 않습니다.

  • 필수 경로 확인(예: /libs/granite/security/currentuser.json이(가) HTTP 503​을(를) 반환함)과 필수 구성 요소(사용자 지정) 확인을 포함하여 상태 확인이 실패했습니다.

  • 로그는 다음과 같은 오류와 함께 인스턴스화에 실패한 사용자 지정 OSGi 구성 요소를 보여 줍니다.

    • javax.jcr.nodetype.NoSuchNodeTypeException: 노드 유형 클라이언트가 없습니다
    • 사용자 지정 인증 또는 저장소 이니셜라이저 구성 요소에 대한 인수가 0인 생성자를 찾을 수 없습니다

원인

사용자 지정 OSGi 구성 요소는 구성 요소 설명자가 일치하지 않거나, JCR 노드 유형이 누락되거나, 팩토리 구성이 잘못되어 인스턴스화되지 못했습니다. 이로 인해 기본 서비스 오류가 발생하고 성공적인 배포를 방해합니다.

해결 방법 resolution

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

  1. 저장소 이니셜라이저 및 인증 번들과 같은 사용자 지정 OSGi 구성 요소에 대한 코드를 검토하십시오.

  2. 사용자 지정 코드에서 폴더 만들기 논리를 실행하기 전에 참조된 모든 JCR 노드 유형(예: client)이 있는지 확인하십시오.

  3. OSGi 구성 요소 설명자가 컴파일된 클래스의 생성자 서명과 일치하는지 확인하십시오.

  4. 사용자 지정 인증 구성 요소(예: ProviderConfigImpl, ProviderConfigServiceManagerImpl, OAuthManagerImpl)에 대한 팩터리 구성이 올바르고 최신 배포에서 새로 도입되거나 수정되지 않았는지 확인하십시오.

  5. 상태 검사 구성의 유효성을 검사합니다.

    • 필수 구성 요소(사용자 지정) 상태 검사에 대한 OSGi 구성을 찾습니다(일반적으로 org.apache.felix.hc.generalchecks.ComponentsCheck에 대한 팩토리 구성, 태그 사용자 지정).

    • 필수 구성 요소 목록에 영향을 받는 사용자 지정 구성 요소가 포함되어 있는지 확인합니다.

    • AEM Touch UI 사용(도구) > 작업 > 상태 검사)를 클릭하여 사용자 지정 상태 검사에 대한 현재 상태 및 메시지를 검토합니다.

  6. 식별된 문제를 수정한 후 영향을 받는 번들을 다시 배포하고 환경이 안정적인 준비 상태에 도달하고 모든 상태 검사가 통과하는지 확인합니다.

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