在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

请按照以下步骤解决问题:

  1. 查看Dispatcher配置并验证是否未为GraphQL持久查询端点/graphql/execute.json/*启用缓存。 控制此行为的配置变量通常为CACHE_GRAPHQL_PERSISTED_QUERIES。 请确保未定义变量或将该变量配置为防止缓存此路径。

  2. 更新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"
    
  3. 应用配置更改并重新加载或重新启动Dispatcher服务。

  4. 通过发送包含Origin标头的请求来测试GraphQL持久查询端点。

  5. 验证响应是否包含预期的Access-Control-Allow-Origin标头。

  6. 验证x-cache响应标头是否返回MISS而不是HIT,确认未从CDN缓存为该响应提供服务。

  7. 查看AEM CORS策略配置,并验证com.adobe.granite.cors.impl.CORSPolicyImpl是否配置为允许端点具有所需的源。

  8. 如果CDN已缓存不包含所需CORS标头的响应,请清除或使受影响端点的缓存失效,以确保后续请求接收正确的标头。

  9. 验证对GraphQL持久查询端点的请求是否返回预期的CORS标头并成功处理。

recommendation-more-help
experience-cloud-kcs-help-kbarticles