ドキュメントExperience Cloud KCS

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

問題を解決するには、次の手順を実行します。

  1. スマート切り抜きエディターとキャッシュバイスククエリパラメーターをテストして、DispatcherのキャッシュまたはDynamic Media CDNのキャッシュが問題の原因であるかどうかを判断します。
  2. Dispatcherを設定して、スマート切り抜きエディターリソースをキャッシュから除外します。 「/libs/dam/gui/content/s7dam/smartcrop/*」のキャッシュ拒否ルールを追加します。 Dispatcherがキャッシュからこれらのリソースを提供しなくなったことを確認します。
  3. Dispatcherのフィルタールールを確認し、スマート切り抜きエディターのパスが明示的に許可されていることを確認します。 スマート切り抜きURLが、HTTP 403または404の応答の代わりに、想定されるコンテンツを返すことを確認します。
  4. Dispatcher キャッシュをクリアして、古いスマート切り抜きエディターのHTML、JavaScript、および関連リソースを削除します。 スマート切り抜きエディターをリロードし、キャッシュバイパスパラメーターなしで動作することを確認します。
  5. アセットを開き、切り抜きハンドル、サイズ変更コントロール、プレビュー画像、エディターコンポーネントが正しく読み込まれることを確認して、スマート切り抜き機能を検証します。
  6. 更新されたスマート切り抜きレンディションが公開後も表示されない場合は、Dynamic Media CDN キャッシュを調査します。 アセットを再公開し、更新されたレンディションがクエリパラメーターなしで表示されるかどうかを確認します。
  7. CDN無効化ワークフロー（または該当する場合はAPI）を使用して影響を受けるDynamic Media アセットを無効化し、影響を受けるページをリロードして、更新されたスマート切り抜きレンディションが表示されることを確認します。
  8. スマート切り抜きプロファイルがアセット間で一貫性がないように見える場合は、影響を受けるフォルダープロパティを開き、設定を保存してフォルダーメタデータを更新します。 正しい画像プロファイルがフォルダーとすべてのアセットに継承されていることを確認します。

関連トピックス

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