在AEM Assets中,具有大写扩展名的PNG文件返回404错误

通过Adobe Experience Manager (AEM) Assets访问时,对于已发布且文件扩展名大写的PNG资源,其筛选器规则会将扩展名视为区分大小写,并且可能仅允许小写扩展名,因此可能会返回​404 Not Found。 虽然资产在DAM中仍然可用,但过滤器会阻止使用大写扩展名的请求。 要解决此问题,请使用小写扩展名标准化资源文件名,或者更新Dispatcher筛选规则以允许使用小写和大写PNG扩展。

描述 description

环境

Adobe Experience Manager (AEM) Assets(使用Dispatcher的所有版本和部署模型)

问题/症状

将具有小写和大写PNG文件扩展名的资源(如asset1.png和asset1.PNG)上传到AEM Assets并在AEM Screens渠道或其他组件中引用时,出现以下症状:

  • 在创作环境中,.png和.PNG资源均可访问并返回​HTTP 200 OK。
  • 在通过Dispatcher访问的发布环境中,.png资源的请求返回​HTTP 200 OK。
  • .PNG资源的请求返回​HTTP 404 Not Found,即使这些资源已发布并在DAM中可用。

根本原因

Dispatcher筛选器将文件扩展名视为区分大小写。 默认情况下,其筛选规则可能仅允许小写扩展名,例如.png。 除非筛选规则明确允许,否则阻止对大写扩展名(如.PNG)的资源请求,从而导致​ HTTP 404 Not Found ​错误。

解决方法 resolution

要解决此问题,请使用以下方法之一:

标准化资产文件扩展名(推荐)

  1. 确保所有上传的资源文件名都使用小写扩展名,如.png而不是.PNG。
  2. 将此命名惯例传达给内容作者和相关团队,以防止问题重复出现。

更新Dispatcher筛选器规则

  1. 找到Dispatcher配置目录并打开筛选规则配置文件。
  2. 添加或更新规则以允许相关DAM路径的.png和.PNG扩展。
  3. 将更改保存到配置文件。
  4. 在测试环境中测试配置,并确认.png和.PNG资源均可访问。
  5. 将更新的配置部署到实时环境。
  6. 刷新缓存以确保更改生效。
  7. 验证是否可通过发布环境访问具有.png和.PNG扩展名的资产。
recommendation-more-help
experience-cloud-kcs-help-kbarticles