Blazor Web App全局设InteractiveServer后，UseStatusCodePagesWithReExecute失效？

问题描述 #

在Blazor Web App中，未全局启用InteractiveServer渲染模式时，使用UseStatusCodePagesWithReExecute("/error")可正常处理无效URL的404错误；但全局设置@rendermode="new InteractiveServerRenderMode(prerender: false)"后，访问未知路径会短暂显示指定的错误页，随后被Blazor默认的<NotFound>组件（显示“Not found”）覆盖，添加自定义<NotFound>组件则会显示自定义内容。

复现步骤 #

• 创建交互模式为“Server”的空Blazor Web App
• 在Program.cs中添加app.UseStatusCodePagesWithReExecute("/error");，此时访问未知路径可正常显示错误页
• 在App.razor中添加全局InteractiveServer渲染模式设置，问题出现

问题解答 #

1. 是否可复现？ #

可以稳定复现，这是Blazor Web App在全局交互式渲染模式下的典型路由冲突场景。

2. 是否为预期行为？ #

属于预期行为，核心原因是路由逻辑的优先级变化：

• 未启用全局交互式模式时，ASP.NET Core的中间件（UseStatusCodePagesWithReExecute）优先处理404请求，直接返回/error页面的内容，Blazor不会重新解析路由。
• 启用全局InteractiveServer模式后，Blazor客户端路由系统会在页面加载完成后接管导航逻辑：初始请求时服务器端中间件返回/error内容，但Blazor启动后会重新解析当前URL，发现该路径未匹配任何Blazor路由，就会触发自身的<NotFound>组件，覆盖服务器返回的初始内容。

3. 能否同时使用全局InteractiveServer渲染模式与UseStatusCodePagesWithReExecute处理404错误？ #

可以实现，需通过以下方式避免路由冲突：

• 方案一：注册Blazor路由匹配/error页面
  在Error组件上添加@page "/error"路由声明，确保Blazor路由系统能识别该路径。这样Blazor启动后解析URL时，会匹配到Error组件，而非触发<NotFound>。
• 方案二：统一Blazor NotFound组件与服务器错误页内容
  自定义<NotFound>组件，使其内容与/error页面一致。这种方式下，服务器端中间件处理初始404请求，Blazor启动后则显示自定义NotFound内容，同时保留中间件对非Blazor路由（如API路径）的404处理能力。
• 方案三：避免全局渲染模式，改为组件级设置
  移除App.razor中的全局渲染模式设置，仅给需要交互式渲染的组件单独指定@rendermode。这种方式下，Blazor不会接管所有导航逻辑，UseStatusCodePagesWithReExecute可正常处理全局404。

内容的提问来源于stack exchange，提问作者Mike Dymond