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 是 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 配合,不复杂但容易忽略后者。











