MVC中使用FileResult返回文件时如何实现强制下载而非浏览器直接打开

问题核心原因 #

当前代码返回文件时未指定Content-Disposition响应头为attachment类型，浏览器会对可识别的MIME类型资源（如图片、PDF、文本文件等）默认执行内嵌打开操作。同时原有代码将文件后缀直接作为ContentType传入的写法不符合HTTP规范，可能导致浏览器识别异常。

调整后的实现代码 #

public FileResult Download(int id)
{
    var file = fileService.GetById(id);
    string filePath = file.FileLocation;
    // 通用二进制流MIME类型，兼容所有文件格式
    string contentType = "application/octet-stream";
    // 提取原始文件名作为下载展示的文件名
    string downloadFileName = Path.GetFileName(file.FileLocation);
    // 处理中文文件名编码，避免不同浏览器下出现乱码
    string encodedFileName = Uri.EscapeDataString(downloadFileName);
    
    // 调用带下载文件名参数的File重载，框架会自动添加Content-Disposition: attachment响应头
    return File(filePath, contentType, encodedFileName);
}

可选补充说明 #

• 如果需要保留正确的文件MIME类型，可以自行维护后缀到标准MIME类型的映射关系，替换application/octet-stream即可，只要设置了attachment属性，浏览器仍会触发下载而非直接打开
• 如需手动控制响应头也可以使用如下写法，效果完全一致：

public FileResult Download(int id)
{
    var file = fileService.GetById(id);
    string filePath = file.FileLocation;
    string contentType = "application/octet-stream";
    string downloadFileName = Uri.EscapeDataString(Path.GetFileName(file.FileLocation));
    
    Response.Headers.Add("Content-Disposition", $"attachment; filename=\"{downloadFileName}\"");
    return File(filePath, contentType);
}

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