在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
要解决此问题,请使用以下方法之一:
标准化资产文件扩展名(推荐)
- 确保所有上传的资源文件名都使用小写扩展名,如
.png而不是.PNG。 - 将此命名惯例传达给内容作者和相关团队,以防止问题重复出现。
更新Dispatcher筛选器规则
- 找到Dispatcher配置目录并打开筛选规则配置文件。
- 添加或更新规则以允许相关DAM路径的
.png和.PNG扩展。 - 将更改保存到配置文件。
- 在测试环境中测试配置,并确认
.png和.PNG资源均可访问。 - 将更新的配置部署到实时环境。
- 刷新缓存以确保更改生效。
- 验证是否可通过发布环境访问具有
.png和.PNG扩展名的资产。
recommendation-more-help
experience-cloud-kcs-help-kbarticles