文档

覆盖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. 导航到工具 > 操作 > Web控制台 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