C#如何实现下载不在wwwroot目录下的文件到用户本地计算机

问题根因分析 #

• 路径格式不规范：Windows下SMB网络共享路径需要使用反斜杠格式（如@"\\服务器地址\共享文件夹名\"），你当前用的正斜杠路径会导致ASP.NET Core底层文件读取识别异常，同时手动拼接路径用+/的方式容易出现斜杠重复/缺失问题，触发路径识别错误。
• 进程权限不足：ASP.NET Core运行进程的默认身份（比如IIS默认的ApplicationPoolIdentity、Kestrel默认服务用户）没有网络共享文件夹的读取权限，就算你当前登录操作系统的用户能访问文件，程序运行时也读不到，这是PhysicalFile无响应也不报错的常见诱因。
• File方法使用逻辑错误：File()方法默认是读取网站根目录（wwwroot）下的相对路径资源，你传入共享文件夹的绝对路径自然会提示文件不存在。
• 额外配置无用：你添加的静态文件中间件配置是用来直接通过URL访问静态资源的，和你当前写接口返回文件的逻辑完全无关，不需要配置，配错了反而会导致请求冲突。
• 前端调用方式错误：如果用AJAX/Fetch异步调用下载接口，浏览器默认不会触发下载行为，就算后端返回了正确的文件流也不会弹出下载框。

修复步骤 #

1. 修正路径拼接逻辑，用.NET官方提供的路径拼接方法避免格式错误：

public FileResult DownloadFileFromFolder()
{
    string filepath = string.Empty;
    IEnumerable results = DataLayer.GetData(111);
    foreach (Objects things in results)
    {
        if (things.ID == num) // 注意确认此处num变量已正确赋值
        {
            // 用Path.Combine自动处理斜杠，避免手动拼接出错
            filepath = Path.Combine(things.FilePath, "copy.xlsx");
            break;
        }
    }
    // 提前校验文件是否存在，方便排查问题
    if (!System.IO.File.Exists(filepath))
    {
        throw new FileNotFoundException("目标文件不存在", filepath);
    }
    // 直接读取文件流返回，比PhysicalFile可控性更高，容易定位报错点
    var fileStream = new FileStream(filepath, FileMode.Open, FileAccess.Read);
    // xlsx文件用正确的MIME类型，避免浏览器识别异常
    return File(fileStream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Returned_file.xlsx");
}

2. 配置进程访问权限：

   • 本地调试场景：确认当前登录Windows的用户有共享文件夹的读取权限
   • IIS部署场景：打开站点对应应用程序池的「高级设置」，把「进程模型-标识」修改为有共享文件夹访问权限的域账号/本地用户，不要使用默认的ApplicationPoolIdentity
   • 服务部署场景：确认运行ASP.NET Core服务的用户账号有共享文件夹的读取权限

3. 修正前端调用逻辑，不要用异步请求调用下载接口，改成以下方式触发下载：

// 方式1：直接打开接口地址
window.open('/你的控制器名称/DownloadFileFromFolder');

// 方式2：动态创建a标签触发下载
const a = document.createElement('a');
a.href = '/你的控制器名称/DownloadFileFromFolder';
a.download = 'Returned_file.xlsx';
document.body.appendChild(a);
a.click();
document.body.removeChild(a);

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