VS2022开发Blazor时_Host.cshtml出现诡异NullReferenceException

该空引用异常的常见诱因及排查方向 #

• 首先是改错了排查对象：你注释_Layout.cshtml里的@RenderBody没有任何效果，这个文件是Razor Pages/MVC框架的布局文件，和Blazor组件的渲染体系完全独立，Blazor组件渲染默认不会走这个文件的逻辑，改它自然解决不了问题。
• 最高概率诱因：路由组件配置错误导致@Body渲染片段为null。Blazor布局里的@Body是LayoutComponentBase提供的RenderFragment类型属性，这个值由路由组件RouteView自动注入，如果你修改了根目录App.razor里的Router配置，漏写了RouteView组件、没给RouteView指定DefaultLayout、或者把Found节点的渲染片段写错，@Body就会是null，渲染时直接抛出空引用，和你具体页面写什么内容没有关系。
• 第二高频诱因：.NET 8+版本Blazor Web App的渲染模式配置不匹配。VS2022创建的高版本Blazor项目支持全局/组件级的Server、WebAssembly、Static SSR渲染模式，如果Program.cs里没有正确添加对应渲染模式的服务、没有在端点映射时开启对应渲染模式，框架初始化组件树时拿不到渲染上下文，也会在布局渲染阶段抛出空引用。
• 小概率诱因：
  • Program.cs里的Blazor管线配置被MVC/Razor Pages的路由配置覆盖，比如你手动加了MapControllerRoute或者MapRazorPages，把Blazor组件的端点路由规则顶掉了，请求进入管线后没有走组件渲染逻辑。
  • 布局里引用的其他组件（比如你代码里的NavMenu）内部存在空引用，异常堆栈显示在布局位置，让你误以为是@Body的问题。
  • 项目引用的第三方组件库、NuGet包和当前SDK版本不兼容，注入了null值的框架服务，打断了正常渲染流程。

快速排查步骤 #

1. 第一步先检查根目录App.razor的Router配置，确保和默认模板逻辑一致，正确传入了RouteView：

<Router AppAssembly="@typeof(App).Assembly">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
    </Found>
    <NotFound>
        <PageTitle>Not found</PageTitle>
        <p role="alert">Sorry, there's nothing at this address.</p>
    </NotFound>
</Router>

重点确认DefaultLayout参数是不是指向你写的MainLayout，不要留空或者指向不存在的布局类。

2. 检查Program.cs的服务和中间件配置，确保Blazor组件渲染管线配置完整，以交互式Server模式为例，必须包含如下核心配置：

// 服务注册阶段
builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();

// 中间件配置阶段，确保在所有静态文件、鉴权中间件之后映射Blazor端点
app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

如果同时配置了MVC、Razor Pages路由，把Blazor的端点映射放到路由规则的最前面，避免被其他路由规则覆盖。

3. 配置确认无误后，先把MainLayout里的<NavMenu />和其他自定义组件全注释，只保留最基础的@Body渲染逻辑，运行确认异常是否消失，再逐段放开代码定位具体出问题的组件。

你贴出来的MainLayout.razor和Index.razor代码本身没有语法问题，空引用肯定是这两个文件之外的管线、路由配置问题导致的。

内容的提问来源于stack exchange，提问作者Johnny Wu