Blazor内外路由异常：含.或/的URL外部路由无法识别

问题背景 #

Blazor页面配置路由 @page "/{area}/{*Id}"，当URL包含.（例如 /doc/some/path.With/dots.txt）时，内部导航可正常命中组件，但通过F5刷新发起外部路由请求时，组件无法被识别。核心原因是服务器默认将带.的URL判定为静态资源请求，未转发给Blazor处理。

解决步骤 #

1. 配置服务器路由回退规则 #

根据你的Blazor托管类型，修改Program.cs中的路由配置，确保含点的URL被转发到Blazor入口：

• Blazor WebAssembly：

  app.MapFallbackToFile("index.html");
  

• Blazor Server：

  app.MapFallbackToPage("/_Host");
  

  若需仅针对特定前缀（如/doc）的路径生效，可使用MapWhen缩小范围：

  app.MapWhen(context => context.Request.Path.StartsWithSegments("/doc"), subApp =>
  {
      subApp.MapFallbackToFile("index.html"); // 对应WASM，Server替换为/_Host
  });
  

2. 调整静态文件中间件行为 #

确保静态文件中间件不会误处理Blazor路由范围内的含点路径：

• 若你的/doc路径下没有需要服务的静态文件，可在静态文件配置中过滤该路径：

  app.UseStaticFiles(new StaticFileOptions
  {
      OnPrepareResponse = ctx =>
      {
          if (ctx.Context.Request.Path.StartsWithSegments("/doc"))
          {
              ctx.Context.Response.StatusCode = StatusCodes.Status404NotFound;
              ctx.Context.Response.ContentLength = 0;
              ctx.Context.Response.Body = Stream.Null;
          }
      }
  });
  

• 注意：UseStaticFiles必须在路由配置之前调用，否则规则不生效。

3. 验证路由参数捕获 #

Blazor的{*Id}参数本身支持捕获含.的路径片段，无需修改路由模板。确认服务器转发后，Blazor即可正常解析参数。

4. 边缘场景测试 #

• 测试多级含点路径（如/doc/a.b/c.d/e.txt）；
• 测试带查询参数的含点URL（如/doc/path.With/dots.txt?param=123），确保服务器能正确转发。

总结：这并非Blazor的Bug，而是服务器默认行为导致的路由转发问题，通过调整服务器路由和静态文件配置即可解决。

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