文档Experience Cloud KCS

AEM Dynamic Media：以AVIF而不是请求的格式交付图像

最近更新： 2026年8月14日

本文介绍如何解决以下问题：即使请求使用Adobe Experience Manager (AEM) Dynamic Media或其他格式，JPG仍会以AVIF格式发送图像。

描述 description

环境

  • Adobe Experience Manager (AEM) Dynamic Media (Open API)

症状

通过AEM Dynamic Media发布资产时，所有图像文件都将以AVIF格式交付，而不考虑其原始类型（例如JPG或PNG）。 即使在以下情况下，也会发生这种情况：

  • 在AEM Dynamic Media设置中，文件扩展名被设置为JPG 。
  • fmt=jpg参数已添加到资产交付URL。

例如，URL如下所示：

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?fmt=jpg

从浏览器保存时，仍会导致文件以AVIF格式交付。 这可能会阻止需要JPG格式的图像的工作流，例如与不支持AVIF的电子邮件生成系统的集成。

原因

默认情况下，AEM Dynamic Media的SmartImaging功能会自动将图像转换为现代格式（如AVIF或WebP）以优化交付。 设置auto-format=false可禁用此行为并保留所请求的图像格式。

解决方法 resolution

请按照以下步骤解决问题：

  1. 查看用于Dynamic Media图像的资产交付URL。
  2. 要覆盖自动格式转换，请将参数auto-format=false附加到图像URL。 例如：

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?auto-format=false

  1. 通过在浏览器或集成工作流中访问更新的URL来测试该URL。 现在，应当使用请求的格式（例如JPG）而不是AVIF来交付图像。
  2. 如果在电子邮件客户端或外部系统中使用图像，请验证该文件是否被识别为正确的格式。
  3. 有关更多详细信息，请参阅AEM Dynamic Media资产交付API文档并搜索 自动格式化 参数。

相关阅读

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