ASP.NET Core Razor Pages如何将URL对应文件直接下载到服务器文件夹

核心实现逻辑 #

不需要经过客户端流转，直接在服务端通过HTTP请求拉取目标URL的文件，写入服务器本地目录即可，官方推荐使用HttpClient完成该操作，不要使用已过时的WebClient类。

实现步骤 #

1. 注册HttpClient服务 #

在项目的Program.cs中添加服务注册：

// 基础配置，无特殊需求直接加这一行即可
builder.Services.AddHttpClient();

// 如果需要自定义超时、请求头等可以用下面的写法，比如设置30分钟超时适配大文件下载
// builder.Services.AddHttpClient(httpClient => 
// {
//     httpClient.Timeout = TimeSpan.FromMinutes(30);
//     httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("YourAppName/1.0");
// });

2. 编写PageModel处理逻辑 #

在你的页面对应PageModel中注入HttpClient和环境变量服务，用于发起下载请求和获取服务器存储路径：

using Microsoft.AspNetCore.Mvc.RazorPages;
using System.Net.Http;
using Microsoft.AspNetCore.Hosting;
using System.IO;

public class YourPageModel : PageModel
{
    private readonly HttpClient _httpClient;
    private readonly IWebHostEnvironment _webHostEnv;

    // 构造函数注入依赖
    public YourPageModel(HttpClient httpClient, IWebHostEnvironment webHostEnv)
    {
        _httpClient = httpClient;
        _webHostEnv = webHostEnv;
    }

    // 对应前端表单提交的处理方法
    public async Task<IActionResult> OnPostDownloadFileAsync(string targetUrl)
    {
        // 基础校验：避免无效请求
        if (string.IsNullOrWhiteSpace(targetUrl) || !Uri.TryCreate(targetUrl, UriKind.Absolute, out var validUri))
        {
            ModelState.AddModelError(string.Empty, "提交的URL不合法");
            return Page();
        }

        try
        {
            // 定义服务器本地保存目录，可自定义为任意有权限的路径，这里示例存放在程序根目录的ServerDownloads文件夹
            var saveDir = Path.Combine(_webHostEnv.ContentRootPath, "ServerDownloads");
            // 目录不存在自动创建
            if (!Directory.Exists(saveDir)) Directory.CreateDirectory(saveDir);

            // 生成保存的文件名，可自定义命名规则，避免重复覆盖
            var fileName = Path.GetFileName(validUri.AbsolutePath);
            // 可选：加GUID前缀避免重名
            // fileName = $"{Guid.NewGuid():N}_{fileName}";
            var fullSavePath = Path.Combine(saveDir, fileName);

            // 发起HTTP请求拉取文件，流拷贝直接写入本地，不占用内存，支持大文件
            using var response = await _httpClient.GetAsync(targetUrl, HttpCompletionOption.ResponseHeadersRead);
            // 校验远程请求是否成功
            response.EnsureSuccessStatusCode();
            // 写入本地文件
            await using var fileStream = new FileStream(fullSavePath, FileMode.Create, FileAccess.Write, FileShare.None);
            await response.Content.CopyToAsync(fileStream);

            // 下载完成后可直接在这里调用你的第三方文件处理逻辑
            TempData["Message"] = "文件已成功下载到服务器";
            return RedirectToPage();
        }
        catch (HttpRequestException ex)
        {
            ModelState.AddModelError(string.Empty, $"远程文件拉取失败：{ex.Message}");
            return Page();
        }
        catch (UnauthorizedAccessException)
        {
            ModelState.AddModelError(string.Empty, "服务器存储目录无读写权限，请检查权限配置");
            return Page();
        }
        catch (Exception ex)
        {
            ModelState.AddModelError(string.Empty, $"下载失败：{ex.Message}");
            return Page();
        }
    }
}

注意事项 #

• 权限配置：你指定的存储目录必须给ASP.NET Core应用的运行身份（如IIS应用池身份、Linux下的www-data用户）开放读写权限，否则会抛出权限异常。
• 安全校验：建议增加URL白名单限制，只允许拉取信任域名下的文件，避免被恶意利用发起非法请求。
• 大文件适配：代码中使用HttpCompletionOption.ResponseHeadersRead参数，不会将整个文件加载到内存，直接流拷贝写入本地，支持GB级大文件下载。
• 异常处理：你可以根据业务需求扩展异常分支的处理逻辑，比如下载失败重试、记录错误日志等。

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