.NET Core API下载功能Content-Disposition Header异常求助

问题描述 #

在.NET Core API的下载功能里，手动添加Content-Disposition响应头后，客户端接收不到这个header。调试时发现：

• 内容头对象的预览里能看到该header，但展开后值为null，代码里没法直接调用它的值
• 后续发现这个header被存储在NonValidated集合下

原因分析 #

.NET Core的HeaderDictionary会自动对header名称做大小写规范化，同时默认会校验header值是否符合HTTP规范。如果Content-Disposition的格式存在问题（比如文件名含特殊字符未编码、header值格式错误），就会被判定为验证不通过，被移到NonValidated集合里，常规索引器就无法获取到它。

解决方法 #

1. 正确构造并编码Content-Disposition值（推荐） #

用ContentDispositionHeaderValue类生成符合规范的header值，自动处理文件名编码问题：

using Microsoft.Net.Http.Headers;

// 构造Content-Disposition对象
var contentDisposition = new ContentDispositionHeaderValue("attachment")
{
    // FileNameStar支持UTF-8文件名，兼容性更好
    FileNameStar = Uri.EscapeDataString("带特殊字符的文件名.txt")
};

// 添加到响应头
Response.Headers.Add(HeaderNames.ContentDisposition, contentDisposition.ToString());

如果需要兼容旧版浏览器，也可以用FileName属性配合编码工具：

using System.Web;

contentDisposition.FileName = HttpUtility.UrlEncode("带特殊字符的文件名.txt");

2. 跳过验证添加header（仅临时排查用） #

如果确认header格式没问题但仍被拦截，可使用TryAddWithoutValidation方法跳过校验：

Response.Headers.TryAddWithoutValidation(HeaderNames.ContentDisposition, "attachment; filename=\"test.txt\"");

3. 读取NonValidated中的header值（仅排查场景） #

如果需要获取已经存放在NonValidated里的header值，可直接访问该集合：

var headerValue = Response.Headers.NonValidated[HeaderNames.ContentDisposition];

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