Blazor Server模式需显式配置三要素：Program.cs中调用AddServerSideBlazor()、app.MapBlazorHub()注册SignalR端点、_Host.cshtml中component的render-mode与MapFallbackToPage路径一致；否则组件会构造两次导致数据重复查询、onclick失效或崩溃。
Blazor Server 的交互模式不是“开个开关就能用”，而是必须显式声明渲染模式、注册对应服务、并处理两次构造的副作用——否则页面能显示，但点击无响应、数据查两遍、甚至直接崩溃。
为什么 render-mode="Server" 不生效？
常见错误是只在 _Host.cshtml 里写了 <component type="typeof(App)" render-mode="Server"></component>，却漏了三件事：
-
Program.cs中没调用builder.Services.AddServerSideBlazor()（注意：不是AddRazorComponents()） - 没注册 SignalR Hub 端点：
app.MapBlazorHub()—— 缺它会导致页面加载后几秒内断连，@onclick完全静默 -
MapFallbackToPage("/_Host")的路径和_Host.cshtml中的render-mode值不一致（比如页面写Server，但组件漏设或误设为Static）
组件为什么被构造两次？
.NET 8 Blazor Server 默认行为：首次响应由服务器同步生成 HTML（含初始状态），随后浏览器立即建立 SignalR 连接，并**再次实例化同一组件**来接管后续交互。这导致：
-
OnInitializedAsync执行两次 —— 数据库查询、HTTP 请求可能重复发起 -
NavigationManager.Uri在第一次构造时为null或不可靠 - 若组件里
@inject HttpContext，第二次构造会抛InvalidOperationException: HttpContext is not available - 正确做法是用
Circuit判断阶段：if (Circuit?.IsConnected == true)再执行需 SignalR 的逻辑
怎么让 @onclick 真正响应？
响应失败往往不是语法问题，而是环境未就绪：
- 确保按钮所在组件的顶层有
@rendermode InteractiveServer（或全局在App.razor设置） - 不要在
OnInitialized里直接调用StateHasChanged()—— SSR 下它无效，且可能干扰首次渲染流程 - 避免在事件处理器中访问
HttpContext或依赖请求上下文的对象；改用IDbContextFactory或IHttpClientFactory等生命周期安全的服务 - 检查浏览器控制台是否有
Failed to connect to signalr hub或Cannot send data while connecting类错误 —— 这说明MapBlazorHub()没配对或被中间件拦截
静态内容页要不要也用 Server 模式？
不需要，也不推荐。像 About、Help 这类纯展示页，用 RenderMode.Static 更合适：
- 不启动 SignalR 连接，无内存/连接数开销
- HTML 可被 CDN 缓存，首屏更快
- 完全规避两次构造、
HttpContext异常等问题 - 只需在组件顶部加
@rendermode Static，并确保不使用@onclick、@oninput等交互指令
混合渲染才是常态：根组件用 InteractiveServer，子页面按需切 Static 或 InteractiveServer。强行统一用 Server，反而把简单页面拖进复杂生命周期里。
