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
请按照以下步骤解决问题:
-
验证环境以确定问题发生在“创作”还是“发布”上,或者同时发生在两者上。 Adobe建议仅在发布层上修改Content-Disposition标头。
-
查看Apache Sling处置过滤器设置。
- 在AEM Web Console中,导航到Apache Sling处置过滤器。
- 如果选中了为所有资源路径启用,请尝试取消选中它并测试PDF是否在新选项卡中打开。
- 如果需要保留 为所有资源路径启用 已选中,请将相关的PDF路径添加到 排除的资源路径 并再次测试。
-
调整发布层的Dispatcher配置。
添加或更新以下规则以覆盖PDF文件的Content-Disposition标头:
code language-none Header unset Content-Disposition Header set Content-Disposition inline -
重新加载Dispatcher配置并清除任何相关的缓存。
-
更改配置后清除CDN和浏览器缓存,以确保应用新标头。
-
通过在PDF文本组件中创作PDF链接来测试AEM链接,并验证单击该链接是否会在新选项卡中打开PDF而不是下载它。
recommendation-more-help
experience-cloud-kcs-help-kbarticles