Blazor WASM托管项目如何处理带.html后缀的URL页面？

方法一：给页面添加多路由（快速实现） #

直接在你的Example.razor页面中添加额外的@page指令，同时支持带.html和不带后缀的路径：

@page "/Example"
@page "/Example.html"

<p>Some example text.</p>

这样访问/Example和/Example.html都会指向这个页面，适合页面数量不多的场景。

方法二：Server端全局URL重写（优雅批量处理） #

因为是--hosted托管项目，所有请求先经过ASP.NET Core Server端，我们可以通过URL重写中间件统一处理.html结尾的路径，无需逐个修改页面：

1. 在Server项目的Program.cs中，添加URL重写规则：
   首先确保引用命名空间：

   using Microsoft.AspNetCore.Rewrite;
   

   然后在app.UseRouting();之前添加重写配置：

   var rewriteOptions = new RewriteOptions()
       // 匹配所有以.html结尾的路径，去掉.html后缀后转发
       .AddRewrite(@"^(.+)\.html$", "$1", skipRemainingRules: true);
   
   app.UseRewriter(rewriteOptions);
   

2. 确保Server端已配置Blazor fallback路由（托管项目默认已配置）：

   app.MapFallbackToFile("index.html");
   

这样，当用户访问/Example.html时，Server会自动将路径重写为/Example，然后由Blazor的路由系统匹配到对应的页面，同时不会影响原有不带.html的路径访问。

补充说明 #

• 如果需要生成带.html的内部导航链接，直接在NavLink或NavigationManager中使用带.html的路径即可，重写规则会自动处理：

  <NavLink href="/Example.html">Example Page</NavLink>
  

• 该方案不会产生代码重复，所有页面逻辑仍集中在Blazor组件中，无需维护静态.html文件。

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