支持用户自定义文件名与下载路径的Web文件下载功能实现

需求 #

• 开发Web应用，需支持从数据库存储的文件中下载
• 用户需能自定义下载文件名，并可选择本地保存路径（类似Chrome下载时的交互）
• 现有多数下载方案不满足该需求，需可行实现思路

当前代码问题 #

自行编写的C#下载代码在Visual Studio中报错，涉及response方法调用与Server.MapPath使用问题，原代码如下：

protected void Page_Load(object sender, EventArgs e)
{
    var file = Request.QueryString("file");
    var hasFile = !String.IsNullOrWhiteSpace(file);

    if (!hasFile)
        return;

    var hasFileExists = File.Exists(Server.MapPath(file));
    if (!hasFileExists)
        return;

    var filepath = Server.MapPath(file);
    var filename = Path.GetFileName(filepath);
    var contentType = GetContentType(filepath);


    var hasValidFileExtension = IsValidFileExtension(filepath);
    var hasReadyForDownLoad = hasValidFileExtension && !String.IsNullOrWhiteSpace(filename) && !String.IsNullOrWhiteSpace(contentType);

    if (!hasReadyForDownLoad)
        return;

    HttpResponse response = HttpContext.Current.Response;
    response.ClearContent();
    response.ContentType = contentType;
    response.AddHeader("Content-Disposition", "Attachment; filename=" + filename + ";");
    response.TransmitFile(filepath);
    response.Flush();
    response.End();

}

// get content type
private string GetContentType(string filepath)
{
    var contentType = "application/octetstream";
    var extension = Path.GetExtension(filepath);

    RegistryKey registryKey = Registry.ClassesRoot.OpenSubKey(extension);

    if (registryKey != null && registryKey.GetValue("Content Type") != null)
        contentType = registryKey.GetValue("Content Type").ToString();

    return contentType;
}

// check is file have valid extension
private bool IsValidFileExtension(string file)
{
    bool isValidFileExtension = false;

    string[] FileExtensions = new string[] { "lic" };


    string extension = Path.GetExtension(file).TrimStart('.');

    if (FileExtensions.Contains(extension, StringComparer.OrdinalIgnoreCase))
    {
        isValidFileExtension = true;
    }

    return isValidFileExtension;
}

解决方案 #

一、修复代码报错 #

原代码的核心错误包括语法问题、安全风险、API使用不当，修复后的代码如下：

using System.IO;
using System.Web;
using System.Web.UI;

public partial class DownloadPage : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        // 获取请求参数中的文件标识
        var fileParam = Request.QueryString["file"];
        if (string.IsNullOrWhiteSpace(fileParam))
            return;

        // 安全校验：仅提取文件名，防止路径遍历攻击
        var safeFileName = Path.GetFileName(fileParam);
        if (string.IsNullOrWhiteSpace(safeFileName))
            return;

        // 假设文件存储在站点根目录下的Files文件夹中
        var filePath = Server.MapPath($"~/Files/{safeFileName}");
        if (!File.Exists(filePath))
            return;

        var originalFileName = Path.GetFileName(filePath);
        // 用系统内置方法获取MIME类型，替代注册表读取（服务器环境可能无权限）
        var contentType = MimeMapping.GetMimeMapping(filePath);
        var isValidExtension = IsValidFileExtension(filePath);

        if (!isValidExtension || string.IsNullOrWhiteSpace(originalFileName) || string.IsNullOrWhiteSpace(contentType))
            return;

        // 处理用户自定义文件名
        var customFileName = Request.QueryString["customName"];
        string finalFileName = originalFileName;
        if (!string.IsNullOrWhiteSpace(customFileName))
        {
            // 保留原文件扩展名，避免用户输入导致文件无法打开
            var fileExtension = Path.GetExtension(originalFileName);
            finalFileName = $"{Path.GetFileNameWithoutExtension(customFileName)}{fileExtension}";
            // 处理特殊字符与中文，避免乱码
            finalFileName = HttpUtility.UrlEncode(finalFileName, System.Text.Encoding.UTF8);
        }

        // 构建下载响应
        Response.Clear();
        Response.ContentType = contentType;
        // 用双引号包裹文件名，支持特殊字符
        Response.AddHeader("Content-Disposition", $"attachment; filename=\"{finalFileName}\"");
        Response.TransmitFile(filePath);
        Response.Flush();
        Response.End();
    }

    private bool IsValidFileExtension(string filePath)
    {
        string[] allowedExtensions = { "lic" };
        var extension = Path.GetExtension(filePath).TrimStart('.').ToLower();
        return allowedExtensions.Contains(extension);
    }
}

修复点说明：

• 修正Request.QueryString的语法错误（从()改为[]）
• 添加路径安全校验，防止路径遍历攻击
• 用MimeMapping.GetMimeMapping替代注册表读取MIME类型（服务器环境更可靠）
• 处理自定义文件名的参数传递与扩展名保留
• 优化Content-Disposition头的格式，支持中文与特殊字符

二、实现用户自定义文件名与下载路径 #

1. 自定义文件名

• 前端页面添加输入框，让用户输入想要的文件名（可提示用户无需输入扩展名）
• 点击下载按钮时，将自定义文件名作为customName参数传递给后端下载接口
• 后端接收参数后，拼接原文件扩展名，生成最终文件名并设置到响应头中

2. 自定义下载路径

• 浏览器安全限制：普通Web应用无法直接指定本地保存路径（浏览器禁止网页访问本地文件系统）
• 替代方案：
  • 引导用户开启浏览器的「下载前询问保存位置」设置（Chrome、Edge、Firefox等均支持），此时浏览器会自动弹出保存对话框，用户可选择路径并修改文件名
  • 若为桌面端封装的Web应用（如Electron），可调用桌面API打开保存对话框，获取用户选择的路径后完成下载（仅适用于桌面封装场景）

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