文件

覆寫AEM "AdaptiveImageServletMappingConfigurationFactory"以取得WebP支援

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 — 網站

問題/症狀

  • 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