HTTP 部署契約
HTTP 標頭:快取政策、重複欄位與下載檔名
貼上的標頭與產生的模板是設定輔助。依賴其行為前,請查證實際回應與接收端。
內容更新: · 維護者:Hung Chi-Hsueh · 修正回報
條件式請求:理解 304,避免覆寫更新
If-None-Match 採不透明標籤的弱比對,W/"rev-7" 可與 "rev-7" 相符。GET/HEAD 相符時可得到 304,其他支援方法則是 412。If-Match 用強比對保護更新,弱標籤不能滿足它。ETag 是提供的識別值,本工具不能據此證明內容相同或已有授權。
一般請求檢查成功後,先判斷 If-Match;未送出才判斷 If-Unmodified-Since。接著判斷 If-None-Match;未送出時 GET/HEAD 才判斷 If-Modified-Since。應解釋日期為何略過,不把所有標頭當成各自獨立的 AND 條件。繼續處理表示交回正常流程,不保證 200。
離線測試器僅接受 IMF-fixdate 日期,舊式日期與閏秒會明示不支援並停止,無效日期條件則說明略過原因。不模擬 Range、CDN 年齡、授權或已知操作先前已成功的例外;仍須另外驗證實際伺服器。
分開處理情境、順序與秘密
請求與回應欄位的意義不同。檢查區塊時應保留重複欄位及順序,Set-Cookie 不能任意攤平成逗號分隔值。從 DevTools 複製的文字,也不一定等於實際 HTTP/1.1 傳輸訊息。
Authorization、Cookie、自訂金鑰,甚至網址或檔名都可能含秘密。保留值的遮罩,分享時只用遮罩報告;在本機顯示值不等於同意外傳。解析只說明語法與情境,不證明真偽或傳輸安全。
儲存、新鮮度與驗證是不同決策
未附欄位清單的 no-cache 允許儲存,但重用前須成功重新驗證。no-store 要求快取不儲存,不是加密或可靠隱私保證。private 阻止共享快取儲存,不是禁止所有瀏覽器儲存。
對共享快取而言,s-maxage 優先於 max-age 與 Expires。實際重用也取決於回應年齡、驗證碼、狀態、方法、Vary、請求指令及實作。存活秒數情境不是快取命中的證明;個人化回應尤其應另查正式標頭與 CDN 設定。
檔名是建議,不是可信任路徑
filename 提供明確 ASCII 替代名稱,filename* 則提供 UTF-8 百分比編碼名稱。引號、反斜線跳脫與延伸參數編碼是不同處理;應拒絕 CR、LF 及其他控制碼,而不是試著修復標頭注入。
接收程式可能清理或替換檔名;不能因路徑分隔符、裝置名稱或副檔名,就允許任意寫入或執行內容。請以實際內容類型及接收瀏覽器測試,單憑產生文字無法證明下載行為安全。
Cache-Control: private, no-cache
→ 瀏覽器可儲存,重用前須重新驗證。
Content-Disposition: attachment; filename="report.csv"; filename*=UTF-8''%E5%A0%B1%E8%A1%A8.csv資料可信度