설명서

AEM SP22/SP23의 호환되지 않는 S3 커넥터로 인한 HTTP 503 오류

Last update: Mon Sep 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

설명 description

환경

AEM (Adobe Experience Manager)

문제/증상

  • S3 데이터 저장소가 활성화된 서비스 팩 22 또는 23으로 업그레이드하면 AEM에 액세스할 수 없게 됩니다

  • HTTP 오류 503:AuthenticationSupport 서비스가 누락되었음을 표시합니다. 요청을 인증할 수 없습니다.

  • 로그는 다음을 포함하여 시작 시 해결되지 않은 OSGi 종속성을 표시합니다.

    • 오류: 번들 '751' 오류 시작 중 … oak-blob-cloud-1.22.6.jar …
    • 확인할 수 없습니다… osgi.wiring.package=org.apache.jackrabbit.guava.common.base(버전> =33.2.0)(!(버전> =34.0.0)

원인

이 문제는 S3 커넥터 버전(oak-blob-cloud-1.22.6.jar)과 AEM 서비스 팩 22 또는 23 간의 비호환으로 인해 발생합니다. 커넥터는 업그레이드된 환경에서 일치하지 않는 Guava와 같은 특정 버전의 지원 라이브러리를 사용합니다. 그 결과 OSGi가 종속성을 해결하지 못하여 AEM이 시작되지 않도록 합니다.

해결 방법 resolution

  1. 커넥터 호환성 확인:

    • AEM SP22 또는 SP23의 경우 S3 Connector v1.10.22를 사용하십시오.
    • Adobe 배포 또는 소프트웨어 배포에서 필요한 JAR을 다운로드합니다.

  2. AEM 서비스 팩 업그레이드:

    • Adobe의 표준 설명서를 따라 SP22 또는 SP23으로 업그레이드하십시오.
    • 호환되지 않는 S3 커넥터로 인해 AEM을 시작하지 못할 수 있습니다.

  3. 호환되지 않는 커넥터 제거:

    1. AEM 인스턴스를 중지합니다.
    2. 다음 디렉터리를 백업합니다. <aem-install>/crx-quickstart/install/
    3. 이전 커넥터 JAR 및 번들을 제거하려면 설치 폴더의 모든 콘텐츠를 삭제합니다.

  4. OSGi 상태 지우기:

    1. AEM을 시작하고 약 1분 동안 실행되도록 합니다.
    2. 인스턴스를 다시 중지하여 오래된 OSGi 참조가 지워졌는지 확인하십시오.

  5. v1.10.22 S3 커넥터 JAR 및 사용자 지정 구성 파일을 다시 <aem-install>/crx-quickstart/install/에 복사합니다.

  6. AEM 인스턴스를 시작합니다.

이제 AEM이 모든 OSGi 종속성이 해결된 상태로 성공적으로 시작해야 합니다.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f