설명서

WebP 지원을 위한 AEM "AdaptiveImageServletMappingConfigurationFactory" 재정의

Last update: Tue Dec 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

AdaptiveImageServletMappingConfigurationFactory 구성에 WebP 확장이 포함되지 않으면 Adobe Experience Manager(AEM)의 이미지 구성 요소가 WebP 자산을 렌더링하지 않습니다. AEM에서 기본 설정(OOTB)을 계속 적용하기 때문에 기본 이름 지정 및 위치를 사용하여 사용자 지정 구성을 배포할 수 없습니다. 이 문제를 해결하려면 구성 파일의 이름을 바꾸고 올바른 폴더에 배치한 다음 패키지를 다시 배포합니다.

설명 description

환경

Adobe Experience Manager(AEM) Managed Services, v6.5 - Sites

문제/증상

  • AEM 이미지 구성 요소는 페이지에서 WebP 이미지를 렌더링하지 않습니다.
  • WebP 지원을 추가하기 위한 사용자 지정 구성은 배포 후 무시됩니다.
  • 시스템이 사용자 지정 구성 대신 기본 AdaptiveImageServletMappingConfigurationFactory 설정을 계속 적용합니다.
  • 업데이트된 구성 파일을 배포한 후에도 WebP 이미지 자산을 사용할 수 없습니다.

해결 방법 resolution

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

  1. 도구(으)로 이동 > 작업 > 웹 콘솔 AEM 6.5 AMS 작성자 인스턴스의 > system/console/configMgr .
  2. AdaptiveImageServletMappingConfigurationFactory을(를) 검색한 다음 com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg의 구성을 열고 복사합니다.
  3. 코드 기반 구성 파일을 com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json(으)로 만들거나 이름을 바꾸십시오.
  4. 이 파일의 파일 확장명 속성에 webp를 포함합니다(예: "fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"]).
  5. 이 파일을 코드 베이스의 작성자 실행 모드 폴더 아래에 넣습니다(예: .../apps/<project>/config.author/(게시를 위해 필요한 경우 config.publish/).
  6. 코드 패키지를 다시 배포합니다.
  7. 배포 후 /system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg이(가) 활성 상태이고 해당 파일 확장명 목록에 webp가 포함되어 있는지 확인하십시오.

관련 읽기

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