Blazor 怎么捕获路由不存在的页面 (404)

Blazor中捕获404页面依靠Router组件的NotFound模板实现，而非HTTP状态码；需在App.razor中配置NotFound内容，并配合静态服务器fallback至index.html。

Blazor 中捕获 404（路由不存在）页面，核心在于利用 NotFound 组件 —— 这是 Blazor Router 内置的兜底机制，不是靠 HTTP 状态码或服务器重定向。

使用 Router 的 NotFound 模板

在 App.razor（或主路由组件）中，Router 组件支持一个 NotFound 属性，它会在所有已注册路由都不匹配时渲染对应内容：

• 该内容可以是纯文本、自定义组件，甚至带导航的页面
• 它不触发真实 HTTP 404 响应（浏览器地址栏仍显示错误路径，状态码仍是 200）
• 适合 SPA 场景下的用户体验兜底

示例：基础 404 页面

在 App.razor 中写：

    
        
    
    
        页面未找到
        
            ❌ 找不到您访问的页面

            路径：@uri

            返回首页
        
    

注意：@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 配合，不复杂但容易忽略后者。