Content-Disposition 解析器

关于 GeekFormat

Content-Disposition 解析

解析下载响应头里的 disposition type、filename 与 filename*，解决中文文件名和 RFC 5987 编码问题。

解析摘要

Disposition Type

attachment

Effective Filename

report Q2.csv

filename

report.csv

filename*

UTF-8''report%20Q2.csv

Builder

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": []
}

在线看懂下载头，先把文件名乱码查清。

适用场景

文件下载后名称乱码或浏览器不按预期预览时，先检查 Content-Disposition 的具体写法
调试导出 Excel、PDF 等附件下载接口时使用生成器构造标准 Content-Disposition 头
检查浏览器内联预览与附件下载行为差异时对比 attachment 和 inline 类型
验证网关或 CDN 透传下载响应头时确认 filename* 的 UTF-8 编码是否正确

功能特点

解析与生成双向操作：既能拆解响应头，也能可视化构造 Content-Disposition
filename 和 filename* 分开看：特别适合中文文件名和 RFC 5987 编码排查
自动检测警告：filename 与 filename* 不一致、缺失等高频问题即时提示
生成结果可一键覆盖输入区继续调试或复制用于服务端配置

使用方法

粘贴 Content-Disposition 响应头内容到解析区，或使用生成器配置各字段
解析模式下查看 disposition 类型、effectiveFilename、filename 和 filename* 值
生成模式下选择 attachment 或 inline，填写 filename 和 UTF-8 文件名
复制生成的 Content-Disposition 内容用于接口调试或服务端配置对照

常见问题

为什么下载文件名会乱码？

最常见的原因是 filename 编码不完整，或只写了 filename 没处理 filename*。把响应头拆开看，通常就能很快定位问题。

attachment 和 inline 有什么区别？

attachment 通常表示下载附件，inline 更倾向于浏览器内联预览。解析后可以直观看到文件的处理方式，方便排查下载与预览行为。

这个工具适合接口联调和文件下载排查吗？

适合。尤其适用于导出 Excel、PDF、压缩包等下载接口，能快速验证文件名、编码和响应头配置是否正确。

可以用来检查中文文件名和 RFC 5987 编码吗？

可以。工具会重点帮助识别 filename 和 filename* 的差异，适合排查中文文件名、空格、特殊字符等兼容问题。

Content-Disposition 解析器