SignalR Core请求头发送机制解析及Dart客户端自定义请求头未生效问题排查

一、SignalR Core 中请求头的发送逻辑 #

SignalR Core 的请求头发送方式和你使用的传输协议直接相关：

• WebSocket 传输：请求头仅在WebSocket 握手阶段发送一次，后续的消息帧不再携带 HTTP 请求头。服务器可以在 Hub.OnConnectedAsync 方法中通过 Context.GetHttpContext()?.Request.Headers 获取这些头信息。
• Server-Sent Events (SSE) / Long Polling 传输：每个请求（包括初始连接、后续的轮询请求）都会携带配置的请求头，服务器可以在每次请求时读取头信息。

无论哪种传输方式，客户端都需要在初始化连接时配置请求头，让 SignalR 客户端库在对应的请求阶段注入这些头。

二、Dart 客户端自定义头未被接收的问题排查 #

看你的代码，核心问题出在请求头的类型不匹配，还有一行无效代码干扰：

1. 错误点分析 #

• 你用了 dart:io 里的 MessageHeaders 类构建头，但 SignalR Dart 客户端（signalr_client 包）的 HttpConnectionOptions.headers 参数要求的是 Map<String, String> 类型，而非 MessageHeaders。库无法识别这个对象，导致自定义头根本没被注入到请求里。
• 代码里有一行无效声明：final connectionOptions = HttpConnectionOptions;，这行完全没用，还容易混淆逻辑，直接删掉就行。

2. 修正后的代码 #

// 直接用 Map<String, String> 定义自定义请求头
final customHeaders = {"CashDeskId": "40089"};
final httpOptions = HttpConnectionOptions(
  logger: transportProtLogger,
  headers: customHeaders
);
final hubConnection = HubConnectionBuilder()
  .withUrl(serverUrl, options: httpOptions)
  .configureLogging(hubProtLogger)
  .build();
await hubConnection.start();

3. 额外验证建议 #

• 确保你的 SignalR Dart 客户端包是最新版本，运行 dart pub upgrade signalr_client 升级，旧版本可能存在头处理的兼容性问题。
• 如果服务器用的是 WebSocket 传输，要在 OnConnectedAsync 里正确读取头：

  public override async Task OnConnectedAsync()
  {
      if (Context.GetHttpContext()?.Request.Headers.TryGetValue("CashDeskId", out var cashDeskId) == true)
      {
          // 处理 CashDeskId
          Console.WriteLine($"Received CashDeskId: {cashDeskId}");
      }
      await base.OnConnectedAsync();
  }
  

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