基于配置项条件化启用JwtBearer认证时遇无认证处理器错误

问题核心：当你关闭认证开关时，控制器上的[Authorize(AuthenticationSchemes = Security.AuthenticationSchemes.Bapi)]指定了一个不存在的认证方案处理器，ASP.NET Core找不到对应处理逻辑，就抛出了No authentication handlers are registered错误。

直接跳过认证注册的方式行不通，因为控制器的授权属性还在强制要求使用指定的认证方案。下面是两种靠谱的解决思路：

思路一：注册“直通式”认证处理器（推荐） #

不管开关是否开启，都为Bapi方案注册对应的处理器——开启时用真实的JwtBearer，关闭时用一个直接通过认证的空处理器，这样控制器的授权属性就能找到对应的处理逻辑。

步骤1：修改ConfigureServices配置 #

public void ConfigureServices(IServiceCollection serviceCollection)
{
    // 为Bapi方案注册处理器，根据开关切换类型
    var authBuilder = serviceCollection.AddAuthentication();
    if (securityActivated)
    {
        authBuilder.AddJwtBearer(Security.AuthenticationSchemes.Bapi, options =>
        {
            // 你的JWT配置逻辑，比如验证密钥、颁发者等
        });
    }
    else
    {
        // 注册空处理器，直接通过认证
        authBuilder.AddScheme<AuthenticationSchemeOptions, PassThroughAuthenticationHandler>(
            Security.AuthenticationSchemes.Bapi, 
            _ => { });
    }

    // 配置授权策略，根据开关调整要求
    serviceCollection.AddAuthorization(options =>
    {
        var bapiPolicy = new AuthorizationPolicyBuilder();
        bapiPolicy.AuthenticationSchemes.Add(Security.AuthenticationSchemes.Bapi);
        
        if (securityActivated)
        {
            // 开启时要求用户必须认证，可添加角色、声明等额外校验
            bapiPolicy.RequireAuthenticatedUser();
            // bapiPolicy.RequireRole("Admin"); // 示例：要求特定角色
        }
        else
        {
            // 关闭时允许所有请求通过
            bapiPolicy.RequireAssertion(_ => true);
        }
        
        options.AddPolicy("BapiPolicy", bapiPolicy.Build());
    });
}

步骤2：实现直通式认证处理器 #

创建一个不需要任何验证就返回认证成功的处理器：

public class PassThroughAuthenticationHandler : AuthenticationHandler<AuthenticationSchemeOptions>
{
    public PassThroughAuthenticationHandler(
        IOptionsMonitor<AuthenticationSchemeOptions> options,
        ILoggerFactory logger,
        UrlEncoder encoder,
        ISystemClock clock)
        : base(options, logger, encoder, clock)
    {
    }

    protected override Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        // 创建一个空的身份凭证，直接标记为认证成功
        var identity = new ClaimsIdentity(Scheme.Name);
        var principal = new ClaimsPrincipal(identity);
        var ticket = new AuthenticationTicket(principal, Scheme.Name);
        
        return Task.FromResult(AuthenticateResult.Success(ticket));
    }
}

步骤3：修改控制器的授权属性 #

把原来指定认证方案的方式改成使用策略：

[Authorize(Policy = "BapiPolicy")]
public class YourController : ControllerBase
{
    // 控制器逻辑
}

思路二：动态移除授权属性（适合简单场景） #

如果不想注册空处理器，可以在启动时根据开关动态移除控制器上的[Authorize]属性。这种方法需要用到IAuthorizationPolicyProvider或者过滤器，但灵活性不如第一种。

示例代码（通过修改MVC过滤器实现）：

public void ConfigureServices(IServiceCollection serviceCollection)
{
    serviceCollection.AddControllers(options =>
    {
        if (!securityActivated)
        {
            // 移除所有要求认证的过滤器
            options.Filters.RemoveAll(typeof(AuthorizeFilter));
            // 或者添加一个允许匿名的全局过滤器
            options.Filters.Add(new AllowAnonymousFilter());
        }
    });

    if (securityActivated)
    {
        // 正常注册JwtBearer和授权配置
        serviceCollection.AddAuthentication()
                .AddJwtBearer(Security.AuthenticationSchemes.Bapi, options =>
                {
                    // JWT配置
                });
        
        serviceCollection.AddAuthorization(options =>
        {
            // 授权配置
        });
    }
}

注意：这种方法会全局移除授权校验，如果只想针对特定控制器/方法生效，需要更精细的判断逻辑。

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