AEM Dispatcher:由于过时/etc.clientlibs缓存,未反映网站更改

本文介绍如何解决由于Adobe Experience Manager (AEM) Dispatcher中未清除/etc.clientlibs下的缓存内容而未显示最近网站更改的问题。

描述 description

环境

Adobe Experience Manager (AEM)与Dispatcher(所有版本)

问题/症状

在使用Dispatcher的Adobe Experience Manager (AEM)环境中,最终用户看不到最近的网站更改,例如横幅、脚本或其他客户端资源的更新。 当/etc.clientlibs下的缓存内容未更新,导致Dispatcher提供过时的资源时,会发生此问题。

  • 使用查询参数(如?v=123)访问页面时,会显示更新的内容(如Cookie横幅或脚本),但直接访问页面时不会显示这些内容。
  • 清除/etc.clientlibs下的相关缓存后,问题即得到解决。

原因

Dispatcher中过时的缓存内容导致无法提供更新的网站资源和脚本,进而导致最终用户看不到最近的更改。

解决方法 resolution

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

  1. 识别受影响的缓存路径:

    • 确定与受影响的站点资源相对应的Dispatcher缓存目录。 通用路径包括/etc.clientlibs以及受影响页面的内容路径,例如/content/<site>/en.html。
  2. 访问Dispatcher服务器:

    • 确保您具有访问和修改Dispatcher缓存目录所需的权限。
  3. 清除相关的Dispatcher缓存:

    • 在每个Dispatcher服务器上,删除受影响路径的缓存内容。 例如,删除/etc.clientlibs目录和任何特定于会话的缓存条目(如果存在)。
    • 如果问题涉及特定页面,则也清除该页面的缓存,例如/content/<site>/en.html。
  4. 验证更改:

    • 无需查询参数即可访问受影响的URL,并验证最新更改是否可见。
    • 使用和不使用查询参数进行测试,以确认一致的行为。

不需要完全清除缓存。 除非发现更广泛的问题,否则请使用目标缓存失效。

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