修复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

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

  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