AEM:由于Content-Disposition标头,文本组件中的PDF链接始终下载

本文说明了为什么在PDF (Adobe Experience Manager)文本组件中创建的AEM链接始终会触发下载,而不是在新的选项卡中打开,并提供了解决问题的步骤。

描述 description

环境

Adobe Experience Manager (AEM),所有版本

问题/症状

  • 在PDF现成文本组件(富文本编辑器)中创作AEM链接时,无论是在新选项卡中还是同一选项卡中将该链接设置为打开,单击该链接始终都会导致下载PDF。
  • PDF的浏览器响应标头包含content-disposition: attachment。
  • 即使尝试通过Dispatcher配置或通过将PDF路径添加到Apache Sling处置过滤器中的排除的资源路径来覆盖标头,此行为也仍然存在。
  • 取消选中部署筛选器中的所有资源路径的 启用 将允许PDF按预期在新选项卡中打开。
  • 此问题可能并非在所有环境或浏览器上均可复制。 在某些情况下,清除CDN缓存可解决此问题。

原因

AEM Publish上的二进制资源(如PDF)的Content-Disposition标头默认设置为attachment。 这会导致浏览器下载文件,而不是内联显示文件。 在Dispatcher层覆盖此标题或调整处置过滤器可以解决此问题。

解决方法 resolution

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

  1. 验证环境以确定问题发生在“创作”还是“发布”上,或者同时发生在两者上。 Adobe建议仅在发布层上修改Content-Disposition标头。

  2. 查看Apache Sling处置过滤器设置。

    • 在AEM Web Console中,导航到Apache Sling处置过滤器。
    • 如果选中了为所有资源路径启用,请尝试取消选中它并测试PDF是否在新选项卡中打开。
    • 如果需要保留 为所有资源路径启用 已选中,请将相关的PDF路径添加到 排除的资源路径 并再次测试。
  3. 调整发布层的Dispatcher配置。

    添加或更新以下规则以覆盖PDF文件的Content-Disposition标头:

    code language-none
    Header unset Content-Disposition
    Header set Content-Disposition inline
    
  4. 重新加载Dispatcher配置并清除任何相关的缓存。

  5. 更改配置后清除CDN和浏览器缓存,以确保应用新标头。

  6. 通过在PDF文本组件中创作PDF链接来测试AEM链接,并验证单击该链接是否会在新选项卡中打开PDF而不是下载它。

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