logo
GeekFormat

Content-Disposition 解析器

Content-Disposition 解析器

解析 Content-Disposition 標頭：配置類型、檔案名稱及 filename*，支援國際化檔案名稱與 RFC 5987 編碼。

解析摘要

配置類型
attachment
有效檔案名稱
report Q2.csv
檔案名稱
report.csv
filename*
UTF-8''report%20Q2.csv

建構器

attachment; filename="report.csv"; filename*=UTF-8''report%20Q2.csv

JSON 預覽

{
  "type": "attachment",
  "parameters": {
    "filename": "report.csv",
    "filename*": "UTF-8''report%20Q2.csv"
  },
  "effectiveFilename": "report Q2.csv",
  "warnings": []
}

線上看懂下載標頭，先把檔名亂碼查清。

相關推薦

Link 回應標頭解析器

Sitemap Inspector

Sitemap Generator

Site Network Audit

Unix 時間戳轉換

時間工具

適用場景

  • 檔案下載後名稱亂碼或瀏覽器不按預期預覽時，先檢查 Content-Disposition 的具體寫法
  • 除錯匯出 Excel、PDF 等附件下載 API 時使用產生器構造標準 Content-Disposition 標頭
  • 檢查瀏覽器內嵌預覽與附件下載行為差異時對比 attachment 和 inline 類型
  • 驗證閘道器或 CDN 透傳下載回應標頭時確認 filename* 的 UTF-8 編碼是否正確

功能特點

  • 下載行為一拆就清楚：預覽、下載、檔名編碼分開看
  • 中文檔名少踩坑：特別適合 filename 和 filename* 相容性排查
  • API 串接必備：適合匯出檔案、附件下載、預覽連結和閘道器透傳場景
  • 解析結果清晰：欄位拆解明確，方便一鍵複製給開發或直接對照伺服器設定

使用方法

  1. 貼上 Content-Disposition 回應標頭內容到解析區，或使用產生器設定各欄位
  2. 解析模式下查看 disposition 類型、effectiveFilename、filename 和 filename* 值
  3. 產生模式下選擇 attachment 或 inline，填寫 filename 和 UTF-8 檔名
  4. 複製產生的 Content-Disposition 內容用於 API 除錯或伺服器設定對照

常見問題

為什麼下載檔名會亂碼？

最常見的原因是 filename 編碼不完整，或只寫了 filename 沒處理 filename*。把回應標頭拆開看，通常就能很快定位問題。

attachment 和 inline 有什麼區別？

attachment 通常表示下載附件，inline 更傾向於瀏覽器內嵌預覽。解析後可以直觀看到檔案的處理方式，方便排查下載與預覽行為。

這個工具適合 API 串接和檔案下載排查嗎？

適合。尤其適用於匯出 Excel、PDF、壓縮檔等下載 API，能快速驗證檔名、編碼和回應標頭設定是否正確。

可以用來檢查中文檔名和 RFC 5987 編碼嗎？

可以。工具會重點幫助識別 filename 和 filename* 的差異，適合排查中文檔名、空格、特殊字元等相容問題。