添加[Authorize]后SignalR WebSocket调用因路由问题失败

• 检查WebSocket请求的认证凭据
  WebSocket握手属于HTTP升级请求，必须携带和协商请求一致的认证信息（比如Bearer Token）。确认React客户端在初始化SignalR连接时，配置了正确的认证头——比如使用accessTokenFactory动态获取token，或者直接在连接的headers中设置。如果WebSocket请求未携带有效凭据，ASP.NET会因授权失败拒绝路由到Hub。

• 确认中间件注册顺序
  在Program.cs中，必须保证app.UseAuthentication()和app.UseAuthorization()在app.MapHub<YourHub>("/your-hub-path")之前调用。SignalR的路由匹配依赖已完成的认证流程，若中间件顺序颠倒，WebSocket请求会未经过认证就到达SignalR，被[Authorize]拦截。

• 验证WebSocket支持是否启用
  确保已在服务配置中添加builder.Services.AddSignalR();，且在管道中注册app.UseWebSockets();，并且UseWebSockets()要放在MapHub之前。协商请求成功不代表WebSocket支持完全正常，若升级请求处理失败，会导致路由异常。

• 排查自定义认证中间件的兼容性
  自定义认证中间件可能仅处理了普通HTTP请求，未适配WebSocket升级请求（特征为GET方法且包含Upgrade: websocket请求头）。修改中间件逻辑，通过context.WebSockets.IsWebSocketRequest识别此类请求，并执行与普通请求一致的认证流程。

• 开启详细日志定位问题
  将Microsoft.AspNetCore.SignalR和Microsoft.AspNetCore.Authentication的日志级别设为Debug或Trace，查看日志中WebSocket请求的认证结果、路由匹配细节。日志会明确显示是认证失败、路由未匹配还是其他错误。

• 检查[Authorize]属性的配置细节
  若使用了自定义授权策略，确认builder.Services.AddAuthorization()中已正确注册该策略，且Hub的[Authorize(Policy = "YourPolicy")]引用正确。同时排查是否存在全局授权策略，避免与Hub的局部授权规则冲突。

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