下载文件名乱码：检查Content-Disposition与实际文件内容

下载得到奇怪名称或直接在浏览器打开时，应核对Content-Disposition和字符编码，同时确认下载响应不是错误页面。

文件字节正确，保存名称仍可能乱码；下载响应也可能意外变成登录HTML。排查时先分清“下载了什么”和“浏览器建议叫什么”，不要只更改前端按钮文字。

操作步骤

检查响应Content-Type与Content-Disposition。需要附件下载时使用适合的attachment声明，并为国际化名称按标准提供filename*，同时考虑兼容性回退。服务端生成名称时剔除路径分隔符和控制字符，不能直接把用户输入拼进响应头。前端download属性也有适用范围，不能假设能控制所有跨域响应。

怎样确认处理正确

分别下载中文、空格与普通英文名称的测试文件，比较保存名称、扩展名、大小和摘要。经过代理或对象存储时，检查头部是否被覆盖。失败响应应清楚报告，避免把错误页面保存成压缩包。浏览器会对不安全名称作自己的调整，所以最终验收需覆盖目标浏览器，而不是只看到响应头正确就结束。

参考资料

资料核对日期：2026年10月28日。以下为官方资料综合整理与操作建议，不代表已经对读者的环境完成实测。

MDN Content-Disposition

下载文件名标准