Asp.Net Core SignalR的协议协商挑战-尧图网站建设

📅 发布时间：2026/6/20 8:17:08

Asp.Net Core SignalR的协议协商挑战

文章目录

前言
一、协议协商的原理
二、常见的协商问题及解决办法
总结

前言

在ASP.NET Core SignalR 里，协议协商是客户端和服务器建立连接时的重要步骤

一、协议协商的原理

SignalR 客户端和服务器在建立连接时，会经历以下协商步骤：
- 客户端向服务器发送一个 HTTP GET 请求，请求路径为/negotiate。
- 服务器返回客户端支持的传输方式（像 WebSocket、Server-Sent Events、长轮询）、访问令牌以及其他配置信息。
- 客户端依据服务器返回的信息，挑选合适的传输方式来建立连接。

二、常见的协商问题及解决办法

1.跨域资源共享（CORS）问题

问题表现：客户端在协商请求时，浏览器控制台显示类似No ‘Access-Control-Allow-Origin’ header is present的错误。

解决办法：
要保证服务器端已正确配置 CORS。
必须启用 SignalR 特定的 CORS 策略。

//跨域
string[] urls =
new[] {
"http://localhost:5173"
}
;
builder.Services.AddCors(opt =>
opt.AddDefaultPolicy(builder => builder.WithOrigins(urls)
.AllowAnyMethod(
).AllowAnyHeader(
).AllowCredentials(
)
)
)
;
app.UseCors(
)
;
app.UseHttpsRedirection(
)
;

2.身份验证和授权问题

问题表现：协商请求返回 401（未授权）或者 403（禁止访问）错误。
解决办法：
要确保客户端在协商请求中正确传递了认证信息。
对服务器端的授权策略进行检查。
```
// 对Hub添加授权要求
[Authorize]
public
class MyHubService: Hub
{
// ...
}
```

3.传输方式不兼容问题

问题表现：客户端和服务器没有共同支持的传输方式。

解决办法：
检查客户端和服务器是否都支持相同的传输方式。
可以在客户端限制传输方式。

// 创建新连接
state.connection =
new signalR.HubConnectionBuilder(
)
.withUrl(state.serverUrl, {
//skipNegotiation: true, // 尝试跳过协商步骤
transport: signalR.HttpTransportType.WebSockets // 限制传输方式，强制使用 WebSockets
}
)
.withAutomaticReconnect({
nextRetryDelayInMilliseconds: retryContext =>
{
state.retryCount = retryContext.previousRetryCount + 1
;
return Math.min(1000 * Math.pow(2
, state.retryCount)
, 30000
)
;
}
}
)
.configureLogging(signalR.LogLevel.Debug) // 启用详细调试日志
.build(
)
;

4.路由配置错误

问题表现：协商请求返回 404（未找到）错误。

解决办法：
确认 Hub 的路由配置无误。

// 配置路由
app.MapHub<MyHubService>("/Hubs/MyHubService");// SignalR 终结点

5.代理和负载均衡器问题

问题表现：在 Kubernetes/IIS ARR 后出现 WebSocket is closed 或协商超时。
解决办法：
- 粘性会话（Sticky Sessions）：
  若使用 WebSocket，需配置负载均衡器保持会话亲和性。
- 转发头配置：
```
app.UseForwardedHeaders(
new ForwardedHeadersOptions {
ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
}
)
;
```
- WebSocket 支持
  IIS 需启用 WebSocket 模块，Azure App Service 配置 webSockets: true。

6.自定义协商（高级）

禁用协商（仅限 WebSocket）
服务器必须启用 WebSocket 并开放正确端口（通常 80/443）。

// 创建新连接
state.connection =
new signalR.HubConnectionBuilder(
)
.withUrl(state.serverUrl, {
skipNegotiation: true
, // 尝试跳过协商步骤
transport: signalR.HttpTransportType.WebSockets // 强制使用 WebSockets
}
)
.withAutomaticReconnect({
nextRetryDelayInMilliseconds: retryContext =>
{
state.retryCount = retryContext.previousRetryCount + 1
;
return Math.min(1000 * Math.pow(2
, state.retryCount)
, 30000
)
;
}
}
)
.configureLogging(signalR.LogLevel.Debug) // 启用详细调试日志
.build(
)
;