求助：Razor Pages中无法下载物理文件的解决方法

问题描述 #

我有一个希望用户能够下载的物理文件，该文件与当前Razor Page位于同一文件夹中。尝试了两种方法均失败：

方法一：页面处理器（Page Handler） #

标记代码

<a asp-page-handler="DownloadHelp" title="Template Help"><img src="~/images/help.png" /></a>

后端代码

public IActionResult OnGetDownloadHelp()
{
    return File("TemplateHelp.pdf", MediaTypeNames.Application.Pdf);
}

结果

出现错误提示「TemplateHelp.pdf未找到」，异常触发在中间件类的await next.Invoke(context);行。

方法二：仅使用标记代码 #

标记代码

<a download href="TemplateHelp.pdf" title="Download Template Documentation"><img src="~/images/help.png" /></a>

结果

文件名出现在下载列表中，但提示「无法下载 - 无文件」。

解决方案 #

针对方法一：修正文件路径获取逻辑 #

File方法默认从wwwroot目录查找文件，而你的文件在Razor Page所在的文件夹（属于ContentRoot目录下的Pages子目录），需明确指定物理路径：

1. 在PageModel中注入IWebHostEnvironment：

private readonly IWebHostEnvironment _webHostEnvironment;

public YourPageModel(IWebHostEnvironment webHostEnvironment)
{
    _webHostEnvironment = webHostEnvironment;
}

2. 修改处理器方法，拼接正确路径：

public IActionResult OnGetDownloadHelp()
{
    // 替换YourPageFolder为实际的Razor Page所在文件夹名称
    var pageFolderPath = Path.Combine(_webHostEnvironment.ContentRootPath, "Pages", "YourPageFolder");
    var filePath = Path.Combine(pageFolderPath, "TemplateHelp.pdf");

    if (!System.IO.File.Exists(filePath))
    {
        return NotFound();
    }

    // 最后一个参数为下载时显示的文件名
    return PhysicalFile(filePath, MediaTypeNames.Application.Pdf, "TemplateHelp.pdf");
}

针对方法二：配置静态文件访问权限（不推荐） #

ASP.NET Core默认不对外暴露Pages目录文件，若要直接通过链接访问，需在Program.cs中配置静态文件中间件：

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "Pages", "YourPageFolder")),
    RequestPath = "/YourPageFolder"
});

然后修改a标签的href：

<a download href="/YourPageFolder/TemplateHelp.pdf" title="Download Template Documentation"><img src="~/images/help.png" /></a>

注意：此方法存在安全风险，Pages目录可能包含敏感视图文件，不建议直接暴露。

更优方案：将文件移至wwwroot目录 #

把TemplateHelp.pdf移到wwwroot下的子目录（如wwwroot/docs/），操作更简单安全：

• 方法一简化为：

return File("~/docs/TemplateHelp.pdf", MediaTypeNames.Application.Pdf);

• 方法二直接使用：

<a download href="~/docs/TemplateHelp.pdf" title="Download Template Documentation"><img src="~/images/help.png" /></a>

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