.NET Core API设置下载文件名后文件无法在新标签页打开如何解决

问题原因 #

ASP.NET Core 中 File() 方法的三个参数重载（字节数组/流、Content-Type、文件名），会默认给响应头添加 Content-Disposition: attachment; filename=xxx 标识。浏览器识别到 attachment 属性后，就会直接触发文件下载，而非在标签页内打开。
而你用两个参数的重载时，框架默认设置为 inline 模式，浏览器就会尝试在当前/新标签页内渲染支持的类型（比如图片、PDF）。

修复方案 #

我们不需要用带文件名的 File 重载，改为手动构造 Content-Disposition 响应头，将打开模式指定为 inline（内联打开），同时传入正确的文件名即可：

using System.Net.Mime;
using Microsoft.Net.Http.Headers; // 如需用到 HeaderNames 常量请引入这个命名空间

[Route("image/{id}")]
[Route("view/{id}")]
[HttpGet]
[AllowAnonymous]
public ActionResult GetImage(string id)
{
    var file = _fileService.Get(id, User);
    
    // 配置内联打开，同时设置正确的文件名
    var contentDisposition = new ContentDispositionHeaderValue("inline");
    contentDisposition.SetHttpFileName(file.FileName); // 自动处理文件名编码，避免中文乱码
    Response.Headers[HeaderNames.ContentDisposition] = contentDisposition.ToString();
    
    // 还是使用双参数的File重载
    return File(file.ByteArray, file.ContentType);
}

这样修改后，浏览器会直接在新标签页打开支持的文件类型，用户点击浏览器自带的下载按钮时，也会使用你指定的正确文件名，而非路由中的ID。

注意事项 #

• 如果返回的文件类型是浏览器不支持内联渲染的类型（比如exe、rar等压缩包），即使设置了inline，浏览器仍然会触发下载，这是浏览器的默认行为，属于正常情况。
• 不要直接手动拼接Content-Disposition头字符串，用ContentDispositionHeaderValue类的SetHttpFileName方法可以自动处理不同语言文件名的编码问题，避免出现文件名乱码。

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