SignalR客户端连接失败主因是未正确调用StartAsync()或调用时机错误；必须用HubConnectionBuilder构建、注册On回调后再await StartAsync()；泛型类型T需与服务端数据结构严格匹配；.NET6+需显式配置WithAutomaticReconnect()及心跳超时参数；Blazor WASM须用完整URL并确保CORS精确配置。
SignalR客户端连接失败：检查 HubConnection 构造和 Start() 调用顺序
signalr 客户端连不上，八成卡在 hubconnection 初始化后没调用 startasync()，或者调用时机不对。它不是“构造完就自动连”，必须显式启动，且不能在未配置完成前调用。
-
HubConnection必须用HubConnectionBuilder构建，直接 newHubConnection会报InvalidOperationException: HubConnection is not in the correct state to perform this operation -
StartAsync()是异步操作，必须await；如果写成同步阻塞（比如 .Wait() 或 .Result），在 UI 线程或 ASP.NET 同步上下文中极易死锁 - 连接前要先注册
On<t>()</t>回调，否则服务端推送过来的消息会被丢弃——回调注册不依赖连接状态，但必须在StartAsync()之前完成
C# 客户端收不到服务端消息：确认方法签名与泛型参数匹配
服务端定义了 SendAsync("Update", data)，客户端却收不到，大概率是 On<t>()</t> 的泛型类型 T 和实际传输的 JSON 结构不一致，导致反序列化失败，消息静默丢弃。
- 服务端发的是匿名对象或
Dictionary<string object></string>，客户端却用On<mydto>("Update")</mydto>—— 只要字段名、嵌套层级、类型（如 int vs string）有一处不匹配，整个消息就不触发回调 - 调试时可临时加
OnClose和OnReconnecting，观察是否频繁断连；再用浏览器 DevTools 的 Network → WS 标签，看原始 WebSocket 帧里有没有对应 message 类型的数据 - 稳妥做法：服务端统一返回强类型 DTO，客户端用完全一致的类（字段名大小写、[JsonPropertyName] 保持同步），避免靠约定猜结构
.NET 6+ 中 HubConnection 不自动重连：手动配置 KeepAliveInterval 和 ServerTimeout
默认情况下，HubConnection 在网络抖动或短暂断网后不会自动重试，而是直接进入 Disconnected 状态。这不是 bug，是设计如此——重连策略需显式声明。
- 必须设置
WithAutomaticReconnect()，且推荐传入自定义策略，比如new[] { TimeSpan.Zero, TimeSpan.FromSeconds(2), TimeSpan.FromSeconds(10) }，否则默认只尝试一次立即重连 -
KeepAliveInterval默认 15 秒，但若代理（如 Nginx）或防火墙主动断开空闲连接，需同步调小该值，并确保ServerTimeout>KeepAliveInterval（建议至少大 5 秒），否则心跳超时会误判为服务端失联 - 重连期间新发的
InvokeAsync()请求会排队，但若重连失败，这些请求会以InvalidOperationException: The connection has been closed结束，需在外层捕获并降级处理
Blazor WebAssembly 客户端跨域失败：CORS 配置和 Hub URL 必须严格一致
本地开发时 SignalR 连接 404 或 000 状态，常见于 Blazor WASM 项目中 hub 地址写成相对路径（如 "/hub"）而实际部署在子路径下，或服务端 CORS 允许源漏掉了 WASM 应用的实际域名。
- WASM 客户端的
HubConnectionBuilder中 URL 必须是完整地址，如"https://api.example.com/hub"，不能用"./hub"或"/hub"—— 浏览器会按当前页面地址拼接，极易出错 - 服务端
AddCors()里WithOrigins()必须包含 WASM 应用的完整协议+域名+端口（如"https://app.example.com"），不支持通配符"*"配合 credentials - SignalR 的 negotiate 请求（GET /hub/negotiate）是预检第一步，若这步 401/403，后续 WebSocket 升级必然失败；可用 curl 模拟请求，确认响应头含
Access-Control-Allow-Origin
最常被忽略的是：服务端 Hub 方法上加了 [Authorize]，但客户端没带 token，negotiate 就 401，整个连接流程静默失败——这时候看控制台只有 WebSocket error，得翻 network 面板找第一个 negotiate 请求的响应内容。
