在Blazor应用开发中，当用户访问未在路由配置中定义的地址时，默认会呈现空白内容，这种情况需要开发者主动捕获并展示自定义的404页面，提升用户使用体验。
Blazor路由捕获404的核心机制
Blazor的路由功能由Router组件实现，该组件内置了NotFound属性，当路由匹配失败时，会自动渲染NotFound属性对应的内容，这就是捕获404页面的核心入口。
Router组件的基础结构
Blazor应用的路由配置通常放在App.razor文件中，基础的Router组件结构如下：
<Router AppAssembly="@typeof(App).Assembly">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
<NotFound>
<p>当前页面不存在</p>
</NotFound>
</Router>
其中Found标签对应路由匹配成功的情况，NotFound标签对应路由匹配失败的情况，我们只需修改NotFound标签内部的内容，就能自定义404页面的展示效果。
Blazor WebAssembly模式实现404捕获
Blazor WebAssembly模式下，路由配置完全在客户端完成，实现404捕获的步骤如下：
第一步：创建自定义404组件
首先创建一个专门的404页面组件，比如NotFoundPage.razor，内容可以根据需求自定义：
@page "/not-found"
<h3>404 页面未找到</h3>
<p>您访问的地址不存在，请检查地址是否正确，或者返回首页。</p>
<button @onclick="GoToHome">返回首页</button>
@code {
[Inject]
public NavigationManager NavigationManager { get; set; }
private void GoToHome()
{
NavigationManager.NavigateTo("/");
}
}
第二步：修改App.razor的Router配置
将NotFound标签的内容替换为自定义的404组件，同时可以设置对应的布局：
<Router AppAssembly="@typeof(App).Assembly">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
<FocusOnNavigate RouteData="@routeData" Selector="h1" />
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<NotFoundPage />
</LayoutView>
</NotFound>
</Router>
这样当用户访问不存在的路由时，就会自动展示NotFoundPage组件的内容。
Blazor Server模式实现404捕获
Blazor Server模式的路由捕获逻辑和WebAssembly模式基本一致，仅部分配置细节有差异：
第一步：确认路由配置位置
Blazor Server应用的路由配置同样在App.razor中，和WebAssembly模式的结构相同。
第二步：自定义NotFound内容
可以直接在NotFound标签内编写404内容，也可以引用自定义组件，示例如下：
<Router AppAssembly="@typeof(App).Assembly" AdditionalAssemblies="new[] { typeof(ClientLib.Program).Assembly }">
<Found Context="routeData">
<RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
</Found>
<NotFound>
<LayoutView Layout="@typeof(MainLayout)">
<div class="text-center mt-5">
<h2>404 您访问的页面不存在</h2>
<p class="text-muted">请确认地址输入是否正确，或联系管理员处理</p>
</div>
</LayoutView>
</NotFound>
</Router>
如果需要引用外部程序集中的路由，可以通过AdditionalAssemblies属性添加对应的程序集，确保路由匹配范围覆盖所有组件。
404页面自定义优化建议
- 可以统一404页面的样式，和应用的整体风格保持一致，避免突兀感。
- 可以在404页面添加返回首页、返回上一页的按钮，提升用户操作的便利性。
- 可以记录404访问的日志，方便后续排查无效的路由访问来源，优化应用的路由配置。
- 如果应用有搜索功能，也可以在404页面添加搜索入口，引导用户找到需要的内容。
常见问题说明
有些开发者会遇到修改NotFound内容后不生效的情况，通常是因为没有正确设置LayoutView，导致404页面的布局没有应用，或者路由配置中存在通配符路由覆盖了所有地址，需要检查路由配置中是否有类似@page "/{*path}"的通配符路由，这类路由会匹配所有地址，导致NotFound不会被触发。
另外，Blazor的路由匹配是区分大小写的，如果定义的路由是小写，用户访问大写地址也会触发404，需要根据业务需求确认是否需要统一路由的大小写规则。