解决由Dispatcher和CDN缓存导致的Dynamic Media智能裁剪故障

最近更新： 2026年7月16日

当Dispatcher缓存或Dynamic Media CDN缓存提供过时或阻止的资源时，Dynamic Media智能裁剪无法正确加载，或在AEM Assets和AEM Sites中显示更新的裁剪演绎版。常见症状包括智能裁切编辑器损坏、裁切手柄缺失和裁切呈现内容陈旧。通过验证Dispatcher缓存和筛选规则、清除缓存的资源、使受影响的CDN内容失效和验证智能裁剪行为来解决问题。

描述 description

环境

Adobe Experience Manager Dynamic Media
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Adobe Experience Manager Managed Services (AMS)
带有Dynamic Media智能裁剪的AEM 6.5

问题/症状

智能裁剪编辑器显示损坏的图像而不是编辑界面。
智能裁剪仅在添加绕过缓存的参数（如?nocache=123）后加载。
在添加绕过缓存的参数后，更新的智能裁剪演绎版才会显示在AEM Sites页面上。
裁切手柄、调整控件大小或预览图像无法正确显示。

原因

Dispatcher将缓存或阻止/libs/dam/gui/content/s7dam/smartcrop/*下的智能裁剪编辑器资源，从而阻止正确加载编辑器。 Dynamic Media CDN缓存还会在资源更新后提供过时的智能裁剪演绎版，直到CDN缓存刷新为止。

解决方法 resolution

执行以下步骤来解决问题：

通过测试带有绕过缓存查询参数的智能裁剪编辑器，确定问题是否由Dispatcher缓存或Dynamic Media CDN缓存引起。
配置Dispatcher以从缓存中排除智能裁剪编辑器资源。为/libs/dam/gui/content/s7dam/smartcrop/*添加缓存拒绝规则。验证Dispatcher是否不再从缓存中提供这些资源。
请查看Dispatcher过滤器规则并确保明确允许使用智能裁剪编辑器路径。确认智能裁剪URL返回的是预期内容，而不是HTTP 403或404响应。
清除Dispatcher缓存以移除过时的智能裁剪编辑器HTML、JavaScript和相关资源。重新加载智能裁剪编辑器，并验证它是否在没有绕过缓存的参数的情况下工作。
通过打开资源并确认正确加载裁切手柄、调整控件大小、预览图像和编辑器组件，验证智能裁切功能。
如果更新的智能裁剪演绎版在发布后仍未显示，请调查Dynamic Media CDN缓存。重新发布资产，并验证更新的演绎版是否在没有查询参数的情况下显示。
通过CDN失效工作流（或适用的API）使受影响的Dynamic Media资产失效，然后重新加载受影响的页面并验证是否显示更新的智能裁剪演绎版。
如果智能裁剪配置文件在资源中显示不一致，请打开受影响的文件夹属性并保存配置以刷新文件夹元数据。验证文件夹和所有资产是否继承了正确的图像配置文件。

解决由Dispatcher和CDN缓存导致的Dynamic Media智能裁剪故障

描述 description

环境

问题/症状

原因

解决方法 resolution

相关阅读