如何在ASP.NET中将特定端点映射到静态HTML文件？

一、标准实现方式 #

1. 单文件场景：用MapGet直接返回物理文件 #

不用提前把文件读进内存，让框架帮你处理文件读取和响应，代码更简洁，还能自动处理缓存相关的HTTP头：

var wwwrootPath = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot");
app.MapGet("/page", () => Results.PhysicalFile(
    Path.Combine(wwwrootPath, "somePage.html"), 
    "text/html"
));

这种方式的优势是框架会自动处理Last-Modified、ETag这些缓存字段，客户端能合理缓存文件，而且文件内容更新后，用户刷新就能看到最新版本，不用重启应用。

2. 多文件场景：用URL重写批量映射 #

如果要给多个自定义端点对应不同的HTML文件，用URL重写更高效，不用写一堆MapGet。先确保你安装了Microsoft.AspNetCore.Rewrite包，然后配置规则：

var rewriteOptions = new RewriteOptions()
    .AddRewrite(@"^page$", "somePage.html", skipRemainingRules: true)
    // 可以加更多规则，比如把/foo映射到foo.html
    .AddRewrite(@"^foo$", "foo.html", skipRemainingRules: true);

app.UseRewriter(rewriteOptions);
// 记得把静态文件中间件放在重写之后
app.UseStaticFiles();

这种方式内部完成路径映射，URL不会变，适合批量配置的场景。

二、你当前实现的潜在问题 #

你现在启动时就把文件读进内存的做法，有几个明显的问题：

• 内存浪费：如果HTML文件体积大，或者要映射的文件多，这些字节数组会一直占着内存，在资源紧张的环境（比如Docker容器）里很不划算。
• 无法实时更新：文件内容改了之后，得重启应用才能生效，用户看到的还是旧内容。
• 缺少缓存支持：自己返回文件的话，得手动写代码处理缓存头，不然客户端每次都得重新下载文件，而框架的PhysicalFile会自动搞定这些。

三、额外优化：静态文件缓存 #

如果想让映射的HTML文件支持缓存，还可以给静态文件中间件加缓存配置：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 设置7天的缓存过期时间
        ctx.Context.Response.Headers.Append(
            "Cache-Control", "public, max-age=604800");
    }
});

配合上面的标准实现，既能实现自定义端点映射，又能让客户端合理缓存文件，减少重复请求。

内容的提问来源于stack exchange，提问作者a-lion