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