Angular对接.NET Core SignalR时WebSocket握手报意外200响应错误
SignalR WebSocket 连接握手报错问题排查
核心报错信息
建立SignalR连接时抛出:Error during WebSocket handshake: Unexpected response code: 200
场景说明
需要搭建WebSocket连接实现服务端与客户端的实时数据更新,现有普通控制器接口可正常获取数据。通过抓包观测到WebSocket请求实际能返回101状态码,尝试过公开渠道可查询到的所有相关修复方案后,报错始终存在。
已实现的代码与配置
客户端侧
SignalR服务封装代码
import { Injectable } from '@angular/core'; import * as signalR from "@aspnet/signalr"; import { environment } from 'src/environments/environment'; import { DiagramsService } from './diagrams.service'; @Injectable({ providedIn: 'root' }) export class SignalRService { constructor() { } public data: DiagramsService[]; private _hubConnection: signalR.HubConnection _url = environment.API_URL; public startConnection = () => { this._hubConnection = new signalR.HubConnectionBuilder() .withUrl(this._url + '/Statistics/OPDailyCount',{ skipNegotiation: true, transport: signalR.HttpTransportType.WebSockets }) .build(); this._hubConnection .start() .then(() => console.log('Connection started')) .catch(err => console.log('Error while starting connection: ' + err)) } public addTransferChartDataListener = () => { this._hubConnection.on('transferchartdata', (data) => { this.data = data; console.log(data); }); } }
组件消费SignalR服务逻辑
constructor(private svcDiagrams : DiagramsService, private svcSignalR : SignalRService, private http : HttpClient) { } ngOnInit(): void { this.svcDiagrams.OPDailyRegistration().subscribe(data => { this._rawData = data; this.value = +this._rawData.value; this.units = 'Current OPD Registration Count'; }); this.svcSignalR.startConnection(); this.svcSignalR.addTransferChartDataListener(); this.startHttpRequest(); } private startHttpRequest = () => { // this.http.get(environment.API_URL+'/Statistics/OPDailyCount') // .subscribe(res => { // console.log(res); // }); this.svcDiagrams.OPDailyRegistration().subscribe(data => { this._rawData = data; this.value = +this._rawData.value; this.units = 'Current OPD Registration Count'; }); }
服务端侧
CORS与SignalR服务配置(Startup.cs)
services.AddCors(options => { options.AddPolicy(name: AllowedOrigin, builder => { builder.WithOrigins("http://localhost:4200") .AllowAnyMethod() .AllowAnyHeader() .AllowCredentials(); }); }); services.AddSignalR();
端点映射配置
app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.MapHub<StatsHub>("/Statistics/OPDailyCount"); });
关联控制器接口代码
[HttpGet] [Route("OPDailyCount")] public async Task<AdmissionStatistics> GetOPDailyRegistrationCount() { var timerManager = new TimeManager(() => _hub.Clients.All.SendAsync("transferchartdata", _repoStatistics.GetOPDailyRegistrationCount())); return await _repoStatistics.GetOPDailyRegistrationCount(); }
问题根源与修复方案
1. 解决路径路由冲突(核心诱因)
当前配置存在同一URL路径同时绑定HTTP控制器接口和SignalR Hub的问题:
- ASP.NET Core 路由匹配规则中,控制器端点优先级高于Hub映射端点,当客户端发起WebSocket握手请求到
/Statistics/OPDailyCount路径时,请求会优先被控制器的GET接口拦截,返回200状态的普通HTTP响应,无法触发WebSocket协议升级流程。这也是报错提示“握手阶段收到非预期200响应”的直接原因。 - 抓包观测到的101状态,通常是带特定查询参数的其他请求返回的结果,并非当前强制跳过协商的WebSocket握手请求的真实响应。
修复方式:
调整Hub映射路径,避开与控制器接口的路径重合,例如将Hub路径修改为独立路径/StatisticsHub/OPDailyCount,对应端点配置改为:
app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.MapHub<StatsHub>("/StatisticsHub/OPDailyCount"); });
客户端连接地址同步替换为调整后的Hub路径即可。
2. 修复实时推送逻辑的生命周期问题
当前控制器代码中,TimeManager定时推送实例是在GET接口方法内部实例化的,方法执行完成后该实例会被垃圾回收,无法长期维持推送逻辑。
修复方式:
将定时推送逻辑从控制器接口中抽离,迁移到Hub类内部,或者通过依赖注入注册为与应用生命周期一致的单例服务,保证推送逻辑可以长期稳定运行。
3. 客户端配置优化
- 建议将已停止维护的
@aspnet/signalr包替换为当前官方持续更新的@microsoft/signalr,减少版本兼容问题。 - 非特殊场景下建议关闭
skipNegotiation: true的强制配置,让SignalR走标准的协商流程,降低路径匹配错误类问题的排查成本。
4. 管道顺序校验
确认CORS中间件的管道配置顺序正确:需将app.UseCors(AllowedOrigin)放在app.UseRouting()之后、app.UseEndpoints()之前,否则CORS规则无法对Hub端点生效。
内容的提问来源于stack exchange,提问作者Chimichangas
相关产品推荐
相关产品推荐

