Blazor Router NotFound动态解析页面引发客户端重载问题

核心原因 #

当直接输入或刷新未通过@page定义的路径时，Blazor Router先匹配已注册路由，匹配失败进入NotFound分支。如果你的CustomRouteLoader未正确拦截浏览器原生导航，或动态加载逻辑让路由系统判定路径仍无法被Blazor处理，浏览器会触发原生HTTP请求，导致整个应用重载（Program.cs重新执行）。而带@page的页面能被路由系统直接匹配，全程由客户端路由接管，不会触发原生请求。

各测试场景差异解释 #

• 原生NotFound无重载：Blazor默认的NotFound仅渲染静态提示内容，路由系统明确判定路径已被处理，不会触发浏览器原生跳转，因此仅显示提示，无应用重载。
• 独立组件引用触发重载：若独立组件的动态加载逻辑存在以下情况，会引发浏览器原生请求：
  • 组件类型获取失败（返回null或抛出未处理异常），路由系统仍认为路径未被处理；
  • 加载组件后未通知Blazor路由系统路径已匹配，浏览器向服务器请求该路径，托管式WASM中服务器返回index.html导致应用重载；
  • 逻辑中意外使用了window.location.href这类原生导航API，而非Blazor的NavigationManager。
• NavigateTo跳转无重载：NavigationManager.NavigateTo会拦截浏览器原生导航事件，全程在Blazor客户端路由系统内处理，即使进入NotFound分支，也不会触发服务器请求，因此不会重载应用。

解决方向 #

• 确保CustomRouteService对不存在的路径返回有效的占位组件，避免返回null或抛出异常；
• 在CustomRouteLoader处理完组件加载后，通过路由上下文或NavigationManager的相关事件通知Blazor系统路径已被处理；
• 统一使用NavigationManager进行路由操作，避免调用浏览器原生导航API；
• 检查服务器端配置（如ASP.NET Core托管应用），确保所有路由指向index.html，让客户端路由全权处理路径匹配。

内容的提问来源于stack exchange，提问作者Asier Cayón Francisco