SignalR握手失败：预期101但服务器返回200（MAUI/WPF客户端）

核心问题分析 #

报错服务器返回状态码'200'，预期'101'本质是WebSocket握手阶段，服务器未返回协议切换所需的101响应，反而返回了200状态（通常是错误页面、重定向或其他非WebSocket响应）。结合本地环境正常、Blazor WASM客户端可正常连接但桌面客户端失败的情况，重点排查Akamai边缘配置、传输协议限制、客户端请求差异三类问题。

解决方案与排查步骤 #

1. 检查Akamai的WebSocket支持配置 #

Akamai默认可能拦截或修改WebSocket请求，需确认以下配置：

• 启用WebSocket协议：在Akamai控制面板中，为目标域名开启WebSockets功能，允许wss://流量完整穿透到后端。
• 排除Hub路径的缓存/改写：对SignalR Hub路径（如/hub/printertool）配置Akamai规则，禁止缓存、HTML改写或异常的HTTP跳转处理，确保WebSocket握手请求头（Upgrade: websocket、Connection: Upgrade）完整转发到后端服务器。

2. 强制客户端使用兼容传输协议 #

桌面客户端（MAUI/WPF）默认优先尝试WebSocket，若Akamai对WebSocket支持存在问题，可强制切换到Server-Sent Events或Long Polling：

_connection = new HubConnectionBuilder()
    .WithUrl(url, options =>
    {
        options.AccessTokenProvider = () => Task.FromResult(token);
        // 强制使用Server-Sent Events，也可替换为HttpTransportType.LongPolling
        options.Transports = HttpTransportType.ServerSentEvents;
    })
    .ConfigureLogging(logging =>
    {
        logging.AddDebug();
        logging.SetMinimumLevel(LogLevel.Trace);
    })
    .WithAutomaticReconnect()
    .Build();

3. 验证Bearer Token传递的准确性 #

WASM客户端依赖浏览器自动处理头信息，桌面客户端需手动确保Token传递正确：

• 确认客户端的token有效，且包含服务器要求的Audience（PrinterTool）。
• 检查服务器OnMessageReceived事件中，config.SignalR.PrinterToolMainHubRoute的路径配置是否与客户端请求的/hub/printertool完全匹配，确保Token能被正确提取。
• 在客户端添加日志，输出请求头中的Authorization字段，确认格式为Bearer {token}且Token未被截断。

4. 修正CORS配置覆盖桌面客户端场景 #

虽然WASM客户端正常，但桌面客户端的来源（如MAUI的app://、WPF的自定义Scheme）可能未被包含在CORS允许列表中：

• 临时将CORS规则改为SetIsOriginAllowed(_ => true)测试，确认是否是CORS导致的拦截（测试完成后需恢复严格配置）。
• 若确认是来源问题，将桌面客户端的自定义Scheme添加到config.SignalR.CorsAddress列表中。

5. 调整服务器中间件顺序 #

确保中间件加载顺序符合SignalR要求：

// 正确顺序：CORS → 认证 → 授权 → 端点映射
app.UseCors(builder =>
{
    builder.AllowAnyMethod()
           .AllowAnyHeader()
           .AllowCredentials()
           .WithOrigins(config.SignalR.CorsAddress)
           .SetIsOriginAllowedToAllowWildcardSubdomains();
});
app.UseAuthentication();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<PrinterToolHub>("/hub/printertool");
    // 其他业务端点配置
});

6. 对比请求差异定位问题 #

用Fiddler或Wireshark抓包，对比WASM与桌面客户端的请求：

• 检查WebSocket握手请求的Upgrade、Connection、Sec-WebSocket-Key等字段是否完整。
• 确认Authorization头的格式和内容一致。
• 查看Akamai返回的200响应内容，判断是错误页面、重定向还是其他拦截结果，定位具体原因。

额外验证步骤 #

• 绕过Akamai，直接用后端服务器IP测试桌面客户端连接，确认问题是否出在边缘层。
• 确保SignalR Client版本与服务器.NET版本匹配（如服务器用.NET 6则客户端用6.0.x系列版本），避免版本不兼容导致的协议差异。

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