You need to enable JavaScript to run this app. Angular对接.NET Core SignalR时WebSocket握手报意外200响应错误
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 00:24:03