ASP.NET OutputCache 快取鍵生成機制深度解析：CreateOutputCachedItemKey 內部邏輯

前言

ASP.NET OutputCache 模組透過 OutputCacheModule 在管線中掛載 ResolveRequestCache（讀取快取）與 UpdateRequestCache（寫入快取）事件。快取分為兩層：快取策略（CachedVary）與 快取資料（CachedRawResponse）。一個策略可對應多筆資料（如依查詢字串、Header 區分）。核心在於 CreateOutputCachedItemKey 如何依據請求特徵生成唯一鍵值。

鍵值生成流程概覽

方法簽名：CreateOutputCachedItemKey(HttpContext context, CachedVary cachedVary)

• 策略鍵：cachedVary = null → 僅含 HTTP 動詞 + 路徑。
• 資料鍵：cachedVary != null → 依策略設定追加 VaryByHeader、QueryString、Form、Custom、ContentEncoding 等維度。

基礎前綴：HTTP 動詞與路徑

StringBuilder builder;
if (verb == HttpVerb.POST) 
    builder = new StringBuilder("a1", path.Length + 2);
else 
    builder = new StringBuilder("a2", path.Length + 2);

builder.Append(CultureInfo.InvariantCulture.TextInfo.ToLower(path));
// 例：GET /Home/Index → "a2/home/index"

策略維度迴圈（H、Q、F 三階段）

對 i = 0..2 執行，分別處理：

每階段邏輯：

1. 附加標記字元（H/Q/F）。
2. 取得對應的鍵名陣列 array 與值集合 serverVarsWithoutDemand。
3. 若 _varyByAllParams == true（即 VaryByParam="*"），則取該集合所有鍵，轉小寫、排序。
4. 逐一追加格式：N{key}V{value}，值為 null 時用 +n+ 代替。

後續固定段落

• C：固定分隔符。
• VaryByCustom：若設定，追加 N{customKey}V{customValue}，值由 GetVaryByCustomString 取得，異常則用 +e+。
• D：POST 非表單且 _varyByAllParams 時，將 Request Body 雜湊 (Base64) 附加。
• E：ContentEncoding，若回應編碼在 _contentEncodings 清單中則附加編碼名稱。

關鍵屬性來源對照表

實務啟示

1. 鍵值爆炸風險：濫用 VaryByParam="*" 或大量 Header 會導致快取碎片化，嚴重浪費記憶體。
2. 自訂 VaryByCustom：可實作 GetVaryByCustomString 依使用者角色、裝置類型等切分快取。
3. 除錯技巧：可透過反射或自訂 OutputCacheProvider 記錄實際生成的鍵值，驗證快取命中率。

理解 CreateOutputCachedItemKey 邏輯，是精準控制 OutputCache 行為、避免「以為快取了其實沒命中」的關鍵。

1. 上一篇文章： ASP.NET MVC Bundle 擴充：透過 XML 設定檔動態管理 JS/CSS 套件
2. 下一篇文章： ASP.NET (C#) 產生 Code39 條碼完整實作：字體繪圖法

ASP.NET 基礎

ASP.NET Web Pages 幫助器生態系統：核心元件、安裝管理與擴充開發

ASP.NET Web Pages - 幫助器完整生態系統：

.NET 關閉模式視窗重新整理父頁面出現「重試」對話框的解決辦法

現象描述 使用 showModalDialog 彈出子頁面，

ASP.NET 動態載入用戶控件至 DataList 並傳遞資料實作

實作情境 需求：頁面以 DataList 顯示所有新聞分類，

.NET 設計模式：工廠方法模式完整解析與實作

模式定義 工廠方法模式定義一個建立物件的介面，由子類別決定實