Blazor Server 服务端调试教程

Blazor Server 调试需直接附加服务端 dotnet 进程，而非仅用浏览器工具；应在 Debug 配置下启动、禁用 JS 调试、在 @code 中设断点，结合条件断点、监视变量、DI 服务调用及 SignalR 详细日志排查问题。

Blazor Server 应用在服务端执行 .NET 代码，UI 更新通过 SignalR 实时推送，因此调试不能只靠浏览器开发者工具——必须连上服务器进程本身。

启动带调试信息的开发服务器

确保项目以 Debug 配置运行，并启用符号生成和调试端口监听：

• 在 launchSettings.json 中确认 "inspectUri" 存在（VS 自动生成），且 "dotnetRunMessages" 设为 true
• 避免勾选“启用 JavaScript 调试”（它对 Blazor Server 的 C# 逻辑无效）
• 直接按 F5 启动（Visual Studio）或 dotnet watch run（CLI），VS 会自动附加到 dotnet.exe 进程

在组件中设置断点并触发

Blazor Server 的 C# 逻辑（如 @code 块、事件处理方法、生命周期方法）均可设断点：

• 在 @code 中点击行号左侧设断点，例如 OnInitializedAsync() 或按钮 onclick 方法内
• 刷新页面或触发交互（如点击按钮），请求会发到服务端，命中后 VS 会暂停并高亮当前上下文
• 注意：OnParametersSet 和 ShouldRender 可能高频触发，建议配合条件断点（右键断点 → “条件…”）

检查组件状态与依赖注入对象

断点暂停后，可直接查看组件实例字段、属性，以及通过 DI 注入的服务：

• 在“局部变量”窗口中展开 this，查看 CurrentCount、WeatherForecasts 等字段值
• 若注入了 IHttpClientFactory 或自定义服务（如 IDataService），可在“即时窗口”输入 ((IDataService)this.DataService).GetStatus() 调用方法
• 鼠标悬停变量可快速查看类型和值；右键变量 → “添加监视”便于持续跟踪

排查 SignalR 连接与渲染异常

常见问题如 UI 不更新、报错 “Connection disconnected”，需结合服务端日志和 SignalR 日志定位：

• 在 Program.cs 中启用详细日志：builder.Logging.SetMinimumLevel(LogLevel.Debug)
• 添加 SignalR 日志过滤：builder.Services.AddServerSideBlazor().AddHubOptions(o => o.EnableDetailedErrors = true)
• 查看输出窗口中的 Microsoft.AspNetCore.SignalR 和 Microsoft.AspNetCore.Components.Server.Circuits 日志，重点关注连接 ID、错误堆栈、电路（Circuit）生命周期事件

基本上就这些。Blazor Server 调试本质是标准的 .NET 进程调试，关键在于别误当成前端调试——所有逻辑都在服务端，断点要打在 C# 里，状态要看服务端内存。