修正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
請依照下列步驟解決問題:
-
請檢閱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標頭,並成功處理。