IE通过jQuery FileDownload下载Unicode文件名文件失败问题

这个问题的核心是IE与现代浏览器对Content-Disposition头的UTF-8编码支持不一致：Chrome等现代浏览器遵循RFC 5987标准，能正确解析filename*=utf-8''...格式的编码文件名，但IE不识别这种格式，会把编码后的字符串直接当成文件名，导致显示异常。

解决方案：构造兼容双浏览器的Content-Disposition头 #

我们需要在响应头中同时提供两种格式的文件名：一种针对IE使用URL编码的filename参数，另一种针对现代浏览器使用RFC 5987标准的filename*参数。这样不同浏览器会自动选择自己支持的格式。

修改你的FileDownloadResult类

在生成响应头的代码部分（比如ExecuteAsync方法），替换原有的Content-Disposition设置逻辑：

public async Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken)
{
    var response = new HttpResponseMessage(HttpStatusCode.OK)
    {
        Content = new StreamContent(_dataStream)
    };

    // 处理文件名编码，兼容IE和现代浏览器
    string rawFileName = _fileName;
    // 针对IE：URL编码UTF-8文件名，替换+为%20（IE会把+解析为空格）
    string ieCompatibleFileName = HttpUtility.UrlEncode(rawFileName, Encoding.UTF8).Replace("+", "%20");
    // 针对现代浏览器：符合RFC 5987的UTF-8编码格式
    string modernCompatibleFileName = HttpUtility.UrlEncode(rawFileName, Encoding.UTF8).Replace("+", "%20");

    // 构造兼容的Content-Disposition头
    var contentDisposition = new ContentDispositionHeaderValue("attachment")
    {
        FileName = ieCompatibleFileName,
        FileNameStar = modernCompatibleFileName
    };
    response.Content.Headers.ContentDisposition = contentDisposition;

    // 设置正确的Content-Type，比如你的文件是png就用image/png
    response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");

    return response;
}

关键细节说明 #

• URL编码的必要性：IE无法直接识别UTF-8编码的非ASCII字符（比如你的ЁФ），必须通过HttpUtility.UrlEncode转成百分号编码格式，同时要把+替换为%20——因为IE会把+解析为空格，而现代浏览器对两种空格表示都支持。
• 双参数共存：filename和filename*同时存在时，IE会忽略不认识的filename*，直接使用filename；Chrome等现代浏览器会优先采用符合标准的filename*，确保文件名正确显示。
• Content-Type设置：记得根据你的文件类型设置正确的Content-Type，如果不确定可以用通用的application/octet-stream。

额外验证 #

修改后测试：

• 在IE中下载，文件名会显示为FRISS_db_DiagramЁФ（正确解析URL编码后的内容）
• 在Chrome中下载，依然保持原有正确的文件名显示

内容的提问来源于stack exchange，提问作者Tarta