在C# ASP.NET Core中实现文件下载至客户端的正确方法

你的问题核心是当前代码返回的是服务器本地的文件路径——本地调试时客户端和服务器是同一台机器，所以能直接读取该路径，但部署后客户端是远程设备，根本访问不了服务器的本地文件系统，自然拿不到文件。

要解决这个问题，你需要修改逻辑，直接把文件流发送给客户端，而不是返回服务器本地路径。以下是具体的修改方案：

1. 调整方法返回类型 #

把返回string改成返回Web框架支持的文件结果类型（以ASP.NET Core为例，返回IActionResult），这样可以直接向客户端输出文件流。

2. 重构文件处理逻辑 #

避免依赖服务器本地文件路径传递，改为生成文件后读取流返回，同时清理临时文件：

public async Task<IActionResult> StudentAnswersBulkDownload(int testId, int[] studentIds)
{
    if (testId <= 0)
    {
        return BadRequest("无效的测试ID");
    }

    var folder = KnownFolderFinder.GetFolderFromKnownFolderGUID(new Guid("374DE290-123F-4565-9164-39C4925E467B"));
    string tempFolderName = Guid.NewGuid().ToString();
    var testEntity = await GetAsync(testId);
    string root = Path.Combine(folder, testEntity.TestName.PadRight(5));
    string subdir = Path.Combine(root, tempFolderName);
    string zipPath = string.Empty;

    try
    {
        Directory.CreateDirectory(root);
        Directory.CreateDirectory(subdir);

        foreach (var studentId in studentIds)
        {
            var test = await GetUserAnswerDocAsync(testId, studentId);
            if (test is null) 
                throw new InvalidOperationException($"找不到学生{studentId}的答题文档");

            var fileNameDetails = await GetStudentFileNameDetails(testId, studentId);
            var appendNo = GenerateRandomNo(); 
            var blob = test.TestDocument;

            // 生成单个学生的docx文件
            string docxFileName = $"{testEntity.TestName.PadRight(5)}-{fileNameDetails.ExamNo.PadRight(5)}-{fileNameDetails.Name}-{fileNameDetails.Surname}-{appendNo}.docx";
            string docxPath = Path.Combine(subdir, docxFileName);

            using (Stream stream = new FileStream(docxPath, FileMode.Create, FileAccess.Write))
            {
                stream.Write(blob, 0, blob.Length);
            }
        }

        // 压缩整个目录为zip
        zipPath = Path.Combine(subdir, $"ExportedAnswers_{DateTime.Now:yyyyMMddHHmmss}.zip");
        ZipFile.CreateFromDirectory(subdir, zipPath, CompressionLevel.Optimal, false);

        // 读取zip文件流，返回给客户端
        using var zipStream = new FileStream(zipPath, FileMode.Open, FileAccess.Read);
        return File(zipStream, "application/zip", Path.GetFileName(zipPath));
    }
    finally
    {
        // 清理临时文件和目录，不管是否成功都执行
        if (!string.IsNullOrEmpty(zipPath) && File.Exists(zipPath))
        {
            File.Delete(zipPath);
        }
        if (Directory.Exists(subdir))
        {
            Directory.Delete(subdir, true);
        }
        if (Directory.Exists(root) && !Directory.EnumerateFileSystemEntries(root).Any())
        {
            // 如果root目录为空，也删除
            Directory.Delete(root, true);
        }
    }
}

3. 关键修改点说明 #

• 用Path.Combine替代字符串拼接路径，避免跨平台问题和路径错误。
• 把原代码中的类字段（比如testEntity、root）改为方法内的局部变量，避免并发请求时的线程安全问题。
• 使用try-finally确保临时文件和目录一定会被清理，不会在服务器上残留垃圾文件。
• 直接返回File结果，指定MIME类型为application/zip，浏览器会自动触发下载弹窗。

额外优化建议 #

• 可以考虑直接在内存中生成压缩包，避免写入服务器本地磁盘，提升性能并减少IO操作。比如使用MemoryStream来处理zip，不需要生成临时文件。
• 原代码中循环内的Syncfusion.ZipArchive逻辑可以去掉，因为最后还是用了ZipFile.CreateFromDirectory打包整个目录，这部分逻辑没有实际生效。

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