Blazor 中捕获 404（路由不存在）页面，核心在于利用
NotFound组件 —— 这是 Blazor Router 内置的兜底机制，不是靠 HTTP 状态码或服务器重定向。
使用 Router 的 NotFound 模板
在
App.razor（或主路由组件）中，
Router组件支持一个
NotFound属性，它会在所有已注册路由都不匹配时渲染对应内容： 该内容可以是纯文本、自定义组件，甚至带导航的页面 它不触发真实 HTTP 404 响应（浏览器地址栏仍显示错误路径，状态码仍是 200） 适合 SPA 场景下的用户体验兜底
示例：基础 404 页面
在
App.razor中写：
<Router AppAssembly="@typeof(App).Assembly">
<Found>
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
<NotFound>
<PageTitle>页面未找到</PageTitle>
<div class="p-4">
<font color="red">❌ 找不到您访问的页面</font><br />
路径：<strong>@uri</strong><br />
<a href="/">返回首页</a>
</div>
</NotFound>
</Router>
注意：
@uri是
Router自动提供的当前 URL（需确保在
NotFound模板内直接使用，无需额外声明）
进阶：跳转前记录或重定向
如果需要做日志、自动跳转或模拟服务端 404 行为，可在
NotFound中调用
NavigationManager： 注入
@inject NavigationManager Navigation用
@onload或组件生命周期（如
OnInitialized）触发逻辑 例如 3 秒后跳回首页：
Navigation.NavigateTo("/", true);（true强制刷新） 如需上报错误路径，可搭配 JS Interop 或 API 日志服务
服务端配合（可选但推荐）
Blazor WebAssembly 部署到静态服务器时，必须配置服务器将所有未知路径 fallback 到
index.html，否则直接 404；Blazor Server 则由 SignalR 连接兜底，一般无需额外配置。常见配置： Nginx：
try_files $uri $uri/ /index.html;IIS：web.config 中添加 rewrite 规则 GitHub Pages / Vercel：启用 SPA 模式或配置 _redirects
基本上就这些。Blazor 的 404 是前端路由层面的“未命中”，关键在
NotFound模板 + 服务端 fallback 配合，不复杂但容易忽略后者。
