Blazor自定义404页面需在App.razor中配置Router的NotFound模板，并为WebAssembly部署启用UseEndpoints.MapFallbackToFile("index.html")，确保客户端路由接管未匹配路径。

Blazor 应用默认不自动处理客户端路由未匹配的情况，所以直接访问一个不存在的路径（比如 /nonexistent）时，页面可能空白、报错，或回退到服务器 404 —— 这不是我们想要的用户体验。要实现真正友好的自定义 404 页面，关键在于：在 Blazor 的客户端路由层拦截未匹配路径，并渲染专属的 NotFound 内容。

在 App.razor 中配置 NotFound 模板

这是最核心且必须的一步。Blazor Router 组件支持内置的 NotFound 参数，用于指定当没有路由匹配时显示的内容。

打开 App.razor（通常位于项目根目录），确保 Router 组件包含 NotFound 块：

    
        
        
    
    
        页面未找到
        
            
404 – 页面不存在
            
抱歉，您访问的地址可能已更改或尚未创建。
            返回首页
        
    

✅ 注意：这个 NotFound 块只对 客户端路由匹配失败 生效（即 Blazor WebAssembly 或 Blazor Server 的前端路由），它不会替代服务器端的 HTTP 404 响应。

确保静态文件中间件正确处理“兜底”请求（Blazor WebAssembly 必做）

对于 Blazor WebAssembly（托管或独立部署），浏览器发起的每个 URL 请求都会先到达服务器（如 Nginx、IIS 或 .NET 的静态文件中间件）。如果服务器找不到对应物理文件，需将请求“重写”回 index.html，让 Blazor 客户端路由接管 —— 否则直接 404。

在 Program.cs（.NET 6+）中，确保静态文件中间件启用了 TryFallbackToPage：

app.UseStaticFiles();
app.UseRouting();
// ✅ 关键：让未匹配的请求回退到 index.html，交由 Blazor 路由处理
app.UseEndpoints(endpoints =>
{
endpoints.MapFallbackToFile("index.html");
});

? 如果你用的是 Azure Static Web Apps、Vercel 或 GitHub Pages，需查阅对应平台的重写规则文档（例如 _redirects 文件或 staticwebapp.config.json），确保所有非资源路径都指向 /index.html。

可选：封装为独立组件提升复用性

把 404 内容抽成单独组件（如 NotFound.razor），更清晰也便于复用：

@* NotFound.razor *@
@page "/404"
@inject NavigationManager Navigation
页面未找到
? 404 Not Found
您访问的页面不存在。
回到首页
@code {
private void GoHome() => Navigation.NavigateTo("/");
}

然后在 App.razor 的 NotFound 区域直接引用它：

验证与调试小贴士

• 不要在浏览器地址栏直接输入带查询参数的非法路径（如 /abc?x=1）来测试——确保是纯路径不匹配，比如 /this-page-does-not-exist
• 打开浏览器开发者工具 → Network 标签，确认该请求状态码是 200 OK（因为是客户端路由），而不是 404（那是服务器拦下来的）
• 若看到白屏 + 控制台报错 Unhandled exception rendering component，检查 NotFound 块内是否误用了 @page 指令或引入了未注入的服务
• Blazor Server 用户还需确认 SignalR 连接正常，否则路由切换可能卡住

基本上就这些。不需要改 Web.config、不用写中间件过滤器、也不用依赖 JavaScript —— Blazor 原生的 Router.NotFound 就是为这事设计的。重点是配对好客户端路由兜底和服务器静态文件重写，404 页面就能既美观又可靠。

# javascript  # java  # html  # js  # 前端  # git  # json  # go  # github  # nginx  # 浏览器  # app 

相关文章： 开心动漫网站制作软件下载,十分开心动画为何停播？  教学网站制作软件,学习*后期制作的网站有哪些？  在线制作视频网站免费,都有哪些好的动漫网站？  公司网站制作价格怎么算,公司办个官网需要多少钱？  如何在腾讯云服务器上快速搭建个人网站？  公司网站制作需要多少钱,找人做公司网站需要多少钱？  如何选择网络建站服务器？高效建站必看指南  如何快速搭建响应式可视化网站？  如何在阿里云完成域名注册与建站？  实例解析angularjs的filter过滤器  如何选择高效可靠的多用户建站源码资源？  安云自助建站系统如何快速提升SEO排名？  建站之星如何通过成品分离优化网站效率？  网站制作外包价格怎么算,招聘网站上写的“外包”是什么意思？  建站之星在线客服如何快速接入解答？  ,交易猫的商品怎么发布到网站上去？  建站之星后台密码遗忘？如何快速找回？  Python如何创建带属性的XML节点  盐城做公司网站,江苏电子版退休证办理流程？  c++怎么用jemalloc c++替换默认内存分配器【性能】  成都网站制作价格表,现在成都广电的单独网络宽带有多少的，资费是什么情况呢？  平台云上自助建站如何快速打造专业网站？  广州顶尖建站服务：企业官网建设与SEO优化一体化方案  ,巨量百应是干嘛的？  成都品牌网站制作公司,成都营业执照年报网上怎么办理？  css网站制作参考文献有哪些,易聊怎么注册？  如何解决VPS建站LNMP环境配置常见问题？  在线教育网站制作平台,山西立德教育官网？  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  建站主机服务器选型指南与性能优化方案解析  小程序网站制作需要准备什么资料,如何制作小程序？  学生网站制作软件,一个12岁的学生写小说，应该去什么样的网站？  如何快速上传自定义模板至建站之星？  代刷网站制作软件,别人代刷火车票靠谱吗？  广平建站公司哪家专业可靠？如何选择？  东莞市网站制作公司有哪些,东莞找工作用什么网站好？  建站之星图片链接生成指南：自助建站与智能设计教程  定制建站哪家更专业可靠？推荐榜单揭晓  如何在宝塔面板中创建新站点？  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办？  c# F# 的 MailboxProcessor 和 C# 的 Actor 模型  如何获取上海专业网站定制建站电话？  宝塔面板如何快速创建新站点？  建站之星如何取消后台验证码生成？  如何在Golang中使用encoding/gob序列化对象_存储和传输数据  头像制作网站在线制作软件,dw网页背景图像怎么设置？  如何通过FTP服务器快速搭建网站？  建站之星2.7模板：企业网站建设与h5定制设计专题  香港服务器如何优化才能显著提升网站加载速度？  如何在万网自助建站中设置域名及备案？