ASP.NET 7 MVC在Apache下如何合法生成HTTP头中的文件名

问题场景 #

ASP.NET 7 MVC应用部署在Debian系统的Apache环境中，需实现浏览器内直接打开PDF文件的功能。现有控制器代码如下：

public async Task<IActionResult> OpenPdf()
{
    byte[] pdf = CreatePdf();
    string filename = "\"',õäöü";
    Response.Headers.Add("Content-Disposition", $"inline; filename={filename}.pdf");
    return File(pdf, "application/pdf");
}

运行时遇到两个问题：

• Chrome抛出ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_DISPOSITION错误，由文件名中的单双引号等特殊字符引发
• 移除引号类字符后，仅Apache环境下出现"header非法控制字符"错误，推测是õäöü这类Unicode字符导致

解决方案 #

1. 遵循HTTP标准编码文件名 #

HTTP的Content-Disposition头处理Unicode文件名需兼顾新旧浏览器兼容性：

• 保留filename参数：用于兼容不支持Unicode的旧浏览器，需生成ASCII兼容的文件名（如移除特殊字符、转拼音等）
• 添加filename*参数：遵循RFC 5987规范，对Unicode文件名做UTF-8编码，适配现代浏览器及严格的HTTP头检查（如Apache的规则）

2. ASP.NET 7中的具体实现 #

直接使用System.Net.Mime.ContentDisposition类自动处理编码，避免手动拼接头的错误：

public async Task<IActionResult> OpenPdf()
{
    byte[] pdf = CreatePdf();
    string originalFilename = "\"',õäöü";
    // 生成兼容旧浏览器的ASCII安全文件名
    string safeAsciiFilename = RemoveInvalidChars(originalFilename) + ".pdf";
    // 构建ContentDisposition对象，自动处理编码
    var contentDisposition = new ContentDisposition
    {
        Inline = true, // 设置为inline实现浏览器内打开
        FileName = safeAsciiFilename,
        FileNameStar = originalFilename + ".pdf" // 原始Unicode文件名，自动编码
    };
    // 添加到响应头
    Response.Headers.Add("Content-Disposition", contentDisposition.ToString());
    return File(pdf, "application/pdf");
}

// 辅助方法：移除文件名中的系统非法字符
private string RemoveInvalidChars(string filename)
{
    char[] invalidChars = Path.GetInvalidFileNameChars();
    return string.Join("", filename.Split(invalidChars).Select(s => s.Trim()));
}

3. 关键说明 #

• filename*参数会被ASP.NET自动编码为UTF-8''编码后的文件名格式，完全符合RFC 5987规范，Apache不会判定为非法字符
• 避免手动拼接Content-Disposition头，使用官方类库能自动处理所有编码细节，规避人为错误
• 旧浏览器若不支持filename*，会自动 fallback 到filename参数的ASCII文件名，保证基本功能可用

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