.NET5 SignalR自定义AuthorizeAttribute被忽略不生效问题

核心问题根因 #

自定义特性完全不生效的核心原因是继承了错误版本的SignalR授权基类：

• 代码中引用的Microsoft.AspNet.SignalR.AuthorizeAttribute是.NET Framework平台下传统SignalR的专属类型，包含的AuthorizeHubConnection、AuthorizeHubMethodInvocation方法都是旧版SignalR的生命周期回调，.NET 5使用的ASP.NET Core版本SignalR完全不会识别、调用这些逻辑。
• ASP.NET Core栈下的SignalR授权体系和.NET Framework版本完全不兼容，旧版的自定义特性实现方式在.NET 5下不会被运行时扫描执行。

修复步骤 #

1. 清理错误的旧版引用 #

删除代码中所有对Microsoft.AspNet.SignalR命名空间的引用，所有SignalR相关类型都从Microsoft.AspNetCore.SignalR及对应微软授权命名空间下引用。

2. 选择正确的自定义授权实现方式 #

ASP.NET Core SignalR没有提供旧版那种可直接重写的授权特性基类，推荐两种实现方式： #

方式一：使用原生授权策略（轻量场景推荐）

不需要自定义特性，直接利用ASP.NET Core内置的授权体系即可实现角色校验：

1. 启动时配置授权策略

   // .NET 5在Startup.ConfigureServices中添加
   services.AddAuthorization(options =>
   {
       options.AddPolicy("UserOnly", policy => policy.RequireRole(Role.User.ToString()));
   });
   

2. 在Hub类或方法上使用内置授权特性

   using Microsoft.AspNetCore.Authorization;
   
   [Authorize(Policy = "UserOnly")]
   public async Task InitConnectionAsync(...)
   {
       // 业务逻辑
   }
   

3. 映射Hub时开启授权校验

   // Startup.Configure中配置终结点
   app.UseEndpoints(endpoints =>
   {
       endpoints.MapHub<你的Hub类>("/hub连接路径").RequireAuthorization();
   });
   

方式二：自定义授权特性+Hub过滤器（复杂逻辑场景）

如果需要保留现有特性写法，通过IHubFilter实现自定义授权拦截：

1. 定义普通特性标记，不需要继承旧版授权基类

   [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
   public class IdentitySignalRAuthorizeAttribute : Attribute
   {
       public Role[] AllowedRoles { get; }
       public IdentitySignalRAuthorizeAttribute(params Role[] roles)
       {
           AllowedRoles = roles;
       }
   }
   
   public enum Role
   {
       Admin,
       User
   }
   

2. 实现Hub过滤器完成授权校验

   public class SignalRCustomAuthorizeFilter : IHubFilter
   {
       public async ValueTask<object> InvokeMethodAsync(
           HubInvocationContext context, 
           Func<HubInvocationContext, ValueTask<object>> next)
       {
           // 优先取方法上的特性，没有再取类上的特性
           var attr = context.HubMethod.GetCustomAttributes<IdentitySignalRAuthorizeAttribute>().FirstOrDefault()
               ?? context.HubMethod.DeclaringType.GetCustomAttributes<IdentitySignalRAuthorizeAttribute>().FirstOrDefault();
           
           if (attr != null)
           {
               var hasPermission = attr.AllowedRoles.Any(role => 
                   context.Context.User.IsInRole(role.ToString()));
               
               if (!hasPermission)
               {
                   throw new HubException("当前用户无权访问该接口");
               }
           }
   
           return await next(context);
       }
   }
   

3. 注册过滤器到SignalR配置

   services.AddSignalR(options =>
   {
       options.AddFilter<SignalRCustomAuthorizeFilter>();
   });
   

4. 使用方式和原有写法完全一致

   [IdentitySignalRAuthorize(Role.User)]        
   public async Task InitConnectionAsync(...)
   {
       // 业务逻辑
   }
   

额外排查点 #

• 如果配置后仍然不生效，检查项目中是否同时装了新旧两个版本的SignalR NuGet包，卸载所有Microsoft.AspNet.SignalR开头的包，只保留Microsoft.AspNetCore.SignalR相关包即可。
• 确认认证中间件顺序正确，app.UseAuthentication()必须放在app.UseAuthorization()、app.UseEndpoints()之前，否则用户身份不会被正确解析。

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