紀錄工作經驗、相關知識,解決技術相關問題。

Javascript, SEO, 網站優化

Cloudflare Ignore query string 設定與 Cache Key 優化實務

Cloudflare Ignore query string 設定與 Cache Key 優化實務 特色圖片

在現代網站架構中,Cloudflare Ignore query string 是提升 CDN 快取命中率(Cache Hit Ratio)的關鍵技術。預設情況下,Cloudflare 會將包含不同查詢字串(Query String)的請求視為獨立資源,這往往導致快取碎片化。若您的專案頻繁使用 UTM 參數或無意義的追蹤參數,透過正確設定 Cache Key 規則,能讓相同資源共用快取物件,減少回源請求。

快速跳轉與重點錨點

一、 核心速查與常見瓶頸對照

1. 常見錯誤寫法的工程瓶頸

處理動態參數時,若不分路徑一律忽略 Query String,會導致以下工程瓶頸:

  • 快取汙染:若忽略了所有參數,可能導致需要參數區分內容的頁面(如分頁 ?page=2)回傳錯誤的快取內容。
  • 參數覆蓋:在未精細設定 Cache Key 的情況下,忽略參數可能導致 API 請求回傳過時資料。
  • 版本參數失效:靜態檔常用 ?v=1 這類參數強制更新;忽略 Query String 後,新舊版本會共用同一個快取物件,更新檔案時需要另外清除快取。

2. 核心機制規格對照表

功能維度預設行為Ignore query string適用場景
Cache Key包含完整 URL(含 Query String)其餘預設元素不變,只省略 Query String靜態資源、不依賴參數的頁面
快取物件數量每種參數組合各一份同一路徑合併為一份廣告追蹤、無效參數
方案所有方案所有方案可用自訂保留或排除特定參數(Query string 自訂選項)僅 Enterprise 方案

二、 關鍵機制解析:底層規範與注意事項

Cloudflare 的快取機制核心在於 Cache Key。當請求到達邊緣節點時,Cloudflare 會根據 Cache Key 決定是否命中快取。

1. Cache Key 的運作順序

Cloudflare 預設的 Cache Key 包含完整 URL(協定、主機名稱與帶有 Query String 的 URI),以及 Origin 等部分請求標頭。設定「Ignore query string」後,Cache Key 仍包含預設的其他元素,只省略 URI 的 Query String。這意味著 example.com/style.css?v=1 與 example.com/style.css?v=2 會共用同一個快取物件,這也是官方文件的範例情境(file.jpg?something=123 與 file.jpg?something=789 共用 Cache Key)。

2. 安全性與瀏覽器端注意事項

  • 安全性考量:Ignore query string 只改變 Cache Key 的組成,不處理請求內容。SQL Injection 是源站應用程式層的漏洞,應在源站做好輸入驗證與參數化查詢。
  • 瀏覽器端行為:Cache Key 是 Cloudflare 邊緣節點判斷是否命中快取的依據,瀏覽器本機快取仍由源站回傳的 Cache-Control 等標頭決定。可搭配 瀏覽器快取設定 一併規劃。

三、 實作範本:生產環境完整程式碼

Cloudflare 官方的 Cache Everything 忽略 Query String 範例使用 Cache Rules 設定,以下範本依該範例調整。

範本一:針對特定路徑忽略所有 Query String

適用於靜態資源或不依賴參數的頁面。

  1. 進入 Caching > Cache Rules,建立新規則。
  2. 條件設定為(路徑與主機名稱為示意值,請換成自己的):
    • Hostname equals example.com
    • Path contains /static/
  3. 在 Cache eligibility 選擇 Eligible for cache(官方範例的設定)。
  4. 在 Cache key 設定區塊的 Query string 選擇 Ignore query string。
  5. 部署規則。

範本二:保留或排除特定參數

若只想保留 page、id 等特定參數,需要使用 Custom cache key 的 Query string 選項。官方文件列出的選項有:

  • All query string parameters:所有參數都納入 Cache Key。
  • All query string parameters except:除了列出的參數,其餘都納入。
  • No query parameters except:只有列出的參數納入。
  • Ignore query string:全部忽略(所有方案可用)。

前三項屬於 Query string 的自訂選項,官方的方案對照表只標示 Enterprise 方案可用;其他方案只能使用 Ignore query string 或預設行為。需要保留 page、id 時,選擇 No query parameters except 並填入這兩個參數名稱,其餘參數(例如 utm_ 系列)就不會納入 Cache Key。

四、 常見問題與排錯(Q&A)

Q1:啟用 Cloudflare Ignore query string 後,如何確保動態參數(如 UTM)不會導致快取命中率下降?

問題原因:UTM 參數是隨機的,若不忽略,每個 UTM 組合都會產生新的快取項目。
解法:針對不依賴參數的路徑,用 Cache Rules 設定「Ignore query string」,UTM 參數就不會再影響 Cache Key。若同一路徑還需要保留其他功能性參數,需使用 Enterprise 方案的自訂 Query string 選項。

Q2:在 Cloudflare 中使用 Ignore query string 是否會增加 SQL Injection 的攻擊風險?

問題原因:誤以為 CDN 忽略參數會掩蓋注入攻擊。
解法:Ignore query string 只改變 Cache Key 的組成,不會過濾請求內容。請務必在源站應用程式層實作嚴格的輸入驗證與參數化查詢。

Q3:如何透過 Cloudflare Cache Key 排除特定的 query string 參數而非全部忽略?

問題原因:需要保留部分功能性參數(如搜尋關鍵字)。
解法:在 Cache Rules 的 Cache key 設定中使用 Query string 自訂選項:「No query parameters except」只納入列出的參數,「All query string parameters except」則排除列出的參數。這些自訂選項在官方方案對照表中僅 Enterprise 方案可用。

Q4:當 Cloudflare Cache Key 忽略 query string 時,瀏覽器端的資源請求行為有何變化?

問題原因:擔心 CDN 行為影響瀏覽器快取。
解法:CDN 的 Cache Key 設定不影響瀏覽器行為。瀏覽器依然會根據您伺服器回傳的 Cache-Control 與 ETag 標頭來決定是否使用本地快取。

Q5:Cloudflare Page Rules 與 Cache Rules 在處理 query string 忽略邏輯上的優先級差異為何?

問題原因:新舊功能並存導致設定衝突。
解法:依 Cloudflare 官方的 Page Rules 遷移文件,新版 Rules 功能的優先權高於 Page Rules;兩者對同一路徑都定義快取設定時,Cache Rules 會覆蓋 Page Rules。建議把快取相關設定集中到 Cache Rules 管理。

Q6:針對 API 端點,設定 Ignore query string 是否會導致錯誤的資料回傳?

問題原因:API 請求通常高度依賴參數(如 ?id=123)。
解法:絕對不要針對 API 端點全域忽略參數。若 API 必須快取,請確保 Cache Key 包含所有必要的識別參數,否則將導致所有使用者看到同一筆資料。

參考資料與延伸閱讀

發佈留言