在AEM as a Cloud Service中,GraphQL持久查询出现CORS错误
本文介绍了在涉及CDN级别缓存时,如何在Adobe Experience Manager as a Cloud Service中解决GraphQL持久查询响应中缺少CORS标头的问题。
描述 description
环境
- Adobe Experience Manager as a Cloud Service
- GraphQL持久查询
- CDN缓存
问题/症状
- 向GraphQL持久查询端点发出跨源请求时,会发生浏览器CORS错误。
- 来自CDN的响应可能缺少所需的CORS标头,从而导致来自不同源的请求失败。
- 由于缺少
Access-Control-Allow-Origin标头,浏览器阻止响应,这会影响Headless或SPA集成。
原因
CDN缓存响应不包含所需的CORS标头,即使为端点禁用了Dispatcher级缓存也是如此。 除非明确指示不要缓存,否则CDN可以提供缓存的响应,而无需必要的标头。
解决方法 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标头并成功处理。