AEM:不一致的查詢引數順序會影響ETag和快取
本文說明在Asset Delivery API或核心影像元件產生的影像URL中,以非確定性方式排序查詢引數,可能會導致Adobe Experience Manager中的ETags不穩定和快取效率低下。 其中提供解決問題的步驟。
說明 description
環境
Adobe Experience Manager as a Cloud Service (所有版本)
問題/症狀
- 在傳遞層級上觀察到HTML頁面快取失效和不一致的ETag值。
- 有些
If-None-Match請求傳回200 OK而非304 Not Modified,導致不必要的下載並降低快取效率。 - 資產傳送API或核心影像元件產生的影像URL包含查詢引數,例如
width、quality和preferwebp,順序未定。 這會導致HTML常值回應主體在請求之間變更,即使內容在功能上完全相同亦然。
不一致的引數順序範例:
/adobe/dynamicmedia/deliver/path/to/image?width=1600&quality=85&preferwebp=true/adobe/dynamicmedia/deliver/path/to/image?quality=85&preferwebp=true&width=1600
原因
未排序的集合,例如HashMap、HashSet或Collectors.toMap(),用來建置查詢引數,導致未確定的排序。 這會導致HTML輸出在請求之間有所差異,並破壞ETag型快取。
解決方法 resolution
請依照下列步驟解決問題:
-
識別負責在受影響元件中產生影像URL的Sling模型或HTL程式碼,例如首頁主圖或輪播。
-
檢查查詢引數是否使用未排序的集合(例如
HashMap、HashSet或Collectors.toMap())進行組裝。 -
重構程式碼以確保確定性引數順序:
- 使用
TreeMap依索引鍵排序引數,確保排序一致。 - 如果插入順序必須保留,請使用
LinkedHashMap並確保各個要求的插入順序一致。
- 使用
-
部署更新的元件。
-
確認產生的影像URL在所有發佈執行個體和請求間具有一致的查詢引數順序。
-
確認發佈執行個體中相同頁面的ETags相同,且CDN/瀏覽器快取如預期般運作,即在適當時傳回
304 Not Modified個回應。
相關閱讀
recommendation-more-help
experience-cloud-kcs-help-kbarticles