修正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 Persisted-query回應,並針對稍後相同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