下载名里的filename和filename*冲突时,中文文件名该看哪个?
一个下载响应同时写了 filename=report.txt 和 filename*=UTF-8''%E6%8A%A5%E5%91%8A.txt,保存名称应该怎么理解?这通常是在兼顾基础名称与扩展编码写法。只盯着URL末尾或前一个filename,容易错过服务端真正表达的中文名称。
这次构造公开响应头演示地址,通过蜘蛛模拟抓取访问。请求详情显示目标返回200;地址很长,是因为参数里包含演示的Content-Disposition值。它不是一份真实业务附件,正文由测试接口生成,不能据此说浏览器已成功保存了报告文件。

星号后面的UTF-8不是普通文件名文字
本地curl取得的原始响应包含:Content-Disposition: attachment; filename=report.txt; filename*=UTF-8''%E6%8A%A5%E5%91%8A.txt。其中扩展参数的UTF-8声明字符集,后面两个单引号之间的语言部分为空,百分号编码对应的中文是“报告”。完整扩展名称为“报告.txt”。
两种参数同时存在时,理解扩展写法的接收端通常优先采用filename*,而filename可以给不支持扩展参数的客户端提供简单备用名。这里不能把百分号字节逐个当作显示文字,也不能把 UTF-8'' 当成实际文件名前缀。

URL查询参数本身也进行了一层编码,因而地址中可能看到 %25E6 一类内容。那是“把包含百分号的头字段放进URL”需要的编码层,不等于最终响应头里的文件名应该再保留一层百分号。核对时应以实际返回的Content-Disposition为起点,避免在浏览器地址栏上反复解码后猜测。
attachment与inline表达处理意图
第二个独立示例返回 Content-Disposition: inline; filename=report.txt。它与attachment表达的处置意图不同:attachment通常建议保存为附件,inline则倾向于按媒体类型在当前上下文展示。文件名参数在适用场景下仍可提供建议名称,但不会因为写了filename就必定弹出下载窗口。

实际保存还受浏览器、发起方式、下载属性和安全规则等影响。本次只保存了HTTP响应,未在浏览器里点击下载、比较跨浏览器最终文件名。因此文章明确的是字段编码与本轮返回值,不承诺每个客户端都会保存出完全相同的名称。
客户端通常还会清理危险路径或不适合作为本地名称的字符。文件名不能被当成可信路径直接拼接到服务器磁盘位置,也不能因为它以某个扩展名结尾,就认定正文已经是对应格式。显示名称、Content-Type和实际字节应分别验证。
排查中文下载名时保存哪些信息
先保留完整响应链,看看最终返回附件内容的是哪一跳,重定向前的头未必就是最终下载使用的头。再核对最终Content-Disposition是否保留扩展参数,代理或对象存储是否重写了它。只有URL末尾没有中文,不能说明服务器无法提供中文名称。
如果要确认用户最终保存结果,应在受控浏览器里完成真实下载,记录建议名称、最终磁盘名称和文件类型,再核对文件哈希。遇到下载路径没有扩展名的情况,可以结合下载内容核对方法继续查看,避免只改了文件名却忽略正文错误页。
网站测速适合补充访问状态与分段耗时;下载名称的结论仍应来自最终响应头和真实客户端保存记录。本文三张图分别是云端抓取、本地扩展名称头与独立inline示例,没有把多个请求拼成一次已经完成的附件下载。