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# 里，状态要看服务端内存。
