文档Experience Cloud KCS

在AEM Dynamic Media中，智能裁剪处理因宽高比错误而失败

最近更新： 2026年8月18日

在Adobe Experience Manager (AEM) Dynamic Media中，当图像处理遇到无效的智能裁剪配置时，智能裁剪处理可能会在生成演绎版期间失败。 Assets上传成功，但无法生成智能裁剪演绎版。 要修复此问题，请查看图像配置文件并更正使用不受支持的宽高比的任意智能裁剪维度。

描述 description

环境

Adobe Experience Manager (AEM) Dynamic Media（所有版本）

问题/症状

  • 在生成智能裁剪演绎版时，Dynamic Media图像处理会特别失败。 基本图像上传成功，但智能裁剪无法生成，并且日志中显示以下错误：

    code language-none 
    Primary Smart Crop failure: Transformer SenseiTransformer:smart-crop failed: Unable to execute Sensei request
Exact aspect-ratio error: The 5th aspect ratio should between 0.05 and 20, but got 21.333333
Combined failure line: Asset Compute worker failed to generate rendition for asset '/content/dam/dm/.../testimage.png'
Failed rendition name: cqdam.machine.metadata.crops.json
Failure reason: Reason: 'GenericError'

  • 图像配置文件UI中未突出显示任何错误，但查看配置文件将显示智能裁切维度（例如，1280 x 60），其纵横比超出支持的范围。

  • 删除无效纵横比可使处理成功。

原因

当图像配置文件中的纵横比超过支持的0.05到20范围时，智能裁剪处理失败，导致在生成演绎版期间出现验证错误。

解决方法 resolution

要解决此问题，请执行以下步骤：

  1. 查看应用于受影响文件夹的图像配置文件。 导航到分配给包含受影响资源的文件夹的图像配置文件或智能裁剪配置文件。
  2. 检查所有配置的智能裁切尺寸，并确认每个纵横比都在支持的0.05至20范围内。 例如，1280 x 60 (21.33)的长宽比超过了支持的最大值。
  3. 删除或调整任何无效的外观比例。 编辑或删除任何超出支持范围的智能裁剪维度。
  4. 如果问题仅在一个环境中发生，请将智能裁切或图像配置文件与处理正确工作环境中的配置文件进行比较，并根据需要调整配置。
  5. 保存更新的用户档案并重新处理受影响的资产。
recommendation-more-help
experience-cloud-kcs-help-kbarticles