Blazor Server站点从.NET 5升级到.NET 6运行空引用报错求助

1. 预渲染模式兼容验证 #

当前报错行使用render-mode="ServerPrerendered预渲染模式，预渲染阶段DI容器未完成全量初始化，若App组件或其依赖的子组件在构造函数、OnInitialized/OnInitializedAsync生命周期中直接注入需要运行时上下文的服务（如AuthenticationStateProvider、HttpContext关联服务、数据库上下文），预渲染阶段无对应实例就会抛出空引用。

• 临时验证方案：将渲染模式修改为render-mode="Server"，若运行正常即可定位为预渲染兼容问题，后续可通过组件内判断宿主环境跳过预渲染阶段执行逻辑，或直接保留非预渲染模式即可。

2. Program.cs 配置校验 #

• 检查必备服务注册：确认存在builder.Services.AddServerSideBlazor()注册语句，且注册位于服务注册阶段，未放置在中间件配置或端点映射之后。
• 核对服务注册完整性：对比原.NET 5项目Startup.cs的服务注册逻辑，确认无自定义服务漏注册、服务生命周期配置错误的问题，App组件依赖的服务未注册会直接导致组件解析时抛空。
• 校验中间件顺序：.NET 6对中间件顺序要求更严格，必须遵循app.UseRouting() → app.UseAuthorization() → app.MapBlazorHub() → app.MapFallbackToPage("/_Host")的顺序，顺序错误会导致组件解析链路失败。

3. 全局using配置校验 #

• 检查Globals.cs中是否遗漏Blazor核心命名空间引用，包括Microsoft.AspNetCore.Components、Microsoft.AspNetCore.Components.Web以及项目自定义组件的命名空间，子组件命名空间未引入会触发隐性空引用。
• 确认Globals.cs的文件生成操作属性为「C# 编译器」，未被设置为嵌入式资源等其他类型，否则全局using不会生效。

4. 基础文件兼容性校验 #

• 检查_Layout.cshtml中Blazor静态资源引用路径，.NET 6正确引用为<script src="_framework/blazor.server.js"></script>，需清除.NET 5时期的旧路径配置。
• 检查App.razor的路由配置，确认<Router>节点正确配置AppAssembly="@typeof(App).Assembly"参数，参数缺失会导致路由解析失败抛空。

5. 精确异常定位方法 #

开启IDE的公共语言运行时异常捕获，调试启动后会直接断到空引用的实际抛出位置，而非仅显示_Host.cshtml的报错行，可直接定位到具体关联的组件或服务。

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