Blazor与Razor同应用路由冲突：AmbiguousMatchException问题排查

我是Blazor新手，在同一个ASP.NET Core应用里实现了带登录功能的Razor页面（登录成功后设置Cookie并重定向）。测试流程如下：

• 启动应用显示index.cshtml；
• 登录后通过表单提交重定向至Blazor页面/secret/home；
• 该页面通过NavManager跳转到/secret/todo/{id}。

运行时出现AmbiguousMatchException错误，提示请求匹配多个端点（Blazor初始化器和Fallback {*path:nonfile}），目前功能看似正常，但担心后续出问题，希望消除这个错误。

错误日志 #

Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware[1]
      An unhandled exception has occurred while executing the request.
      Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches:

  Blazor initializers
  Fallback {*path:nonfile}
     at Microsoft.AspNetCore.Routing.Matching.DefaultEndpointSelector.ReportAmbiguity(Span`1 candidateState)
     at Microsoft.AspNetCore.Routing.Matching.DefaultEndpointSelector.ProcessFinalCandidates(HttpContext httpContext, Span`1 candidateState)
     at Microsoft.AspNetCore.Routing.Matching.DefaultEndpointSelector.Select(HttpContext httpContext, Span`1 candidateState)
     at Microsoft.AspNetCore.Routing.Matching.DfaMatcher.MatchAsync(HttpContext httpContext)
     at Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware.Invoke(HttpContext httpContext)
     at Microsoft.AspNetCore.StaticFiles.StaticFileMiddleware.Invoke(HttpContext context)
     at Microsoft.AspNetCore.Authorization.AuthorizationMiddleware.Invoke(HttpContext context)
     at Microsoft.AspNetCore.Authentication.AuthenticationMiddleware.Invoke(HttpContext context)
     at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddlewareImpl.Invoke(HttpContext context)

Program.cs代码 #

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddRazorComponents().AddInteractiveServerComponents();

builder.Services.AddHttpContextAccessor();

builder.Services.AddHttpContextAccessor();
builder.Services.AddTransient<FakeAuthRepo>();
builder.Services.AddSingleton<UserService>();
builder.Services.AddSingleton<IAuthRepo, FakeAuthRepo>();

var app = builder.Build();

app.UseStaticFiles();
app.UseRouting();

app.UseHttpsRedirection();

app.UseAntiforgery();
app.MapControllers();
app.MapBlazorHub();
app.MapRazorPages();

app.MapRazorComponents<App>().AddInteractiveServerRenderMode();

app.MapFallbackToFile("index.html");

app.Run();

这个错误的核心原因是路由规则冲突：MapRazorComponents<App>()配合AddInteractiveServerRenderMode()已经自动配置了Blazor应用的回退路由，而你手动添加的MapFallbackToFile("index.html")又重复定义了回退规则，导致请求匹配时出现歧义。

解决步骤：

1. 移除app.MapFallbackToFile("index.html");这一行代码，保留MapRazorComponents<App>().AddInteractiveServerRenderMode()即可，它会自动处理Blazor应用的所有非API、非Razor页面的路由回退。
2. 可选优化：代码里重复添加了builder.Services.AddHttpContextAccessor();，删掉其中一行，保持代码整洁。

修改后的关键代码片段：

// ... 其他代码保持不变
app.MapRazorComponents<App>().AddInteractiveServerRenderMode();

// 移除重复的回退规则
// app.MapFallbackToFile("index.html");

app.Run();

内容的提问来源于stack exchange，提问作者Benny Jørgensen