修复AEM as a Cloud Service中GraphQL持久查询的CORS标头缺失
本文介绍当CDN缓存受到干扰时,如何在Adobe Experience Manager as a Cloud Service中解决GraphQL持久查询响应上缺少CORS标头的问题。 该解决方案涉及更新缓存控制标头,以防止CDN缓存并确保CORS标头存在。
描述 description
环境
- Adobe Experience Manager as a Cloud Service发布或预览
- GraphQL persisted-query终结点:
/graphql/execute.json/* - 通过Adobe管理的CDN进行跨域浏览器访问
问题/症状
- 当跨源应用程序请求GraphQL持久查询时,浏览器会报告CORS错误。
- 请求包含
Origin标头,但CDN响应不包含所需的Access-Control-Allow-Origin标头。 - 来自不同源的重复请求会收到缓存的响应,而无需使用所需的CORS标头。 响应标头显示缓存
HIT和非零Age。 - 持久查询端点的Dispatcher缓存已禁用,但Adobe管理的CDN仍会提供缓存的响应。
- 已在AEM中配置OSGi CORS策略,但发布响应仍缺少CORS标头。
原因
Adobe管理的CDN缓存了没有Access-Control-Allow-Origin的GraphQL持久查询响应,并提供了对以后对同一URL的请求的响应。 禁用Dispatcher缓存不会禁用Adobe CDN缓存。 对于发布和预览,请在Dispatcher vhost中配置CORS;发布和预览服务不对此配置使用OSGi CORS策略。
解决方法 resolution
请按照以下步骤解决问题:
-
查看Dispatcher配置并验证是否未为GraphQL持久查询端点
/graphql/execute.json/*启用缓存。 控制此行为的配置变量通常为CACHE_GRAPHQL_PERSISTED_QUERIES。 请确保未定义变量或将该变量配置为防止缓存此路径。 -
更新Dispatcher vhost配置以使用
mod_headers,并将GraphQL持久查询端点的Cache-Control标头设置为private, no-store, no-cache, must-revalidate, max-age=0。code language-none Header set Cache-Control “private, no-store, no-cache, must-revalidate, max-age=0” -
应用配置更改并重新加载或重新启动Dispatcher服务。
-
通过发送包含
Origin标头的请求来测试GraphQL持久查询端点。 -
验证响应是否包含预期的
Access-Control-Allow-Origin标头。 -
验证
x-cache响应标头是否返回MISS而不是HIT,确认未从CDN缓存为该响应提供服务。 -
查看AEM CORS策略配置,并验证
com.adobe.granite.cors.impl.CORSPolicyImpl是否配置为允许端点具有所需的源。 -
如果CDN已缓存不包含所需CORS标头的响应,请清除或使受影响端点的缓存失效,以确保后续请求接收正确的标头。
-
验证对GraphQL持久查询端点的请求是否返回预期的CORS标头并成功处理。