ASP.NET Core 7中如何正确在服务扩展中注入IOptionsMonitor？

错误原因 #

你遇到的「IOptionsMonitor是类型，在此上下文中无效」错误，本质是错误地将IOptionsMonitor<OktaOptions>作为扩展方法的参数传入，而不是通过依赖注入容器内部获取实例。扩展方法是针对IServiceCollection的，不能直接将依赖注入类型作为外部参数传递。

修复步骤及代码示例 #

1. 确保引用必要命名空间

在扩展类文件顶部添加：

using Microsoft.Extensions.Options;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using System.IdentityModel.Tokens.Jwt;

2. 正确实现认证服务扩展方法

不要将IOptionsMonitor<OktaOptions>作为方法参数，而是在方法内部通过依赖注入容器获取，或者更推荐使用IConfigureNamedOptions封装配置逻辑（符合DI设计原则）。

方案一：直接在扩展方法内获取配置

public static class AuthenticationServiceExtensions
{
    public static IServiceCollection AddAuthenticationService(this IServiceCollection services)
    {
        // 构建临时服务提供者获取Okta配置
        using var sp = services.BuildServiceProvider();
        var oktaOptions = sp.GetRequiredService<IOptionsMonitor<OktaOptions>>().CurrentValue;

        services.AddAuthentication(options =>
        {
            options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
            options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
        })
        .AddJwtBearer(options =>
        {
            options.Authority = $"{oktaOptions.OktaDomain}/oauth2/{oktaOptions.AuthorizationServerId}";
            options.Audience = oktaOptions.Audience;
            options.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = true,
                ValidateAudience = true,
                ValidateLifetime = true,
                ValidateIssuerSigningKey = true
            };
        });

        return services;
    }
}

方案二：使用IConfigureNamedOptions封装配置（推荐）

这种方式更符合依赖注入的松散耦合设计，避免直接构建服务提供者：

// 扩展方法
public static class AuthenticationServiceExtensions
{
    public static IServiceCollection AddAuthenticationService(this IServiceCollection services)
    {
        services.AddAuthentication(options =>
        {
            options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
            options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
        })
        .AddJwtBearer()
        // 绑定配置逻辑类
        .ConfigureOptions<JwtBearerOptionsConfigurer>();

        return services;
    }
}

// 配置逻辑类，自动注入IOptionsMonitor<OktaOptions>
public class JwtBearerOptionsConfigurer : IConfigureNamedOptions<JwtBearerOptions>
{
    private readonly IOptionsMonitor<OktaOptions> _oktaOptions;

    public JwtBearerOptionsConfigurer(IOptionsMonitor<OktaOptions> oktaOptions)
    {
        _oktaOptions = oktaOptions;
    }

    public void Configure(string? name, JwtBearerOptions options)
    {
        var oktaSettings = _oktaOptions.CurrentValue;
        options.Authority = $"{oktaSettings.OktaDomain}/oauth2/{oktaSettings.AuthorizationServerId}";
        options.Audience = oktaSettings.Audience;
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true
        };
    }

    public void Configure(JwtBearerOptions options)
    {
        Configure(Options.DefaultName, options);
    }
}

3. Program.cs中调用扩展方法

此时直接调用即可，无需传入任何参数：

var builder = WebApplication.CreateBuilder(args);

// 先注册你的Okta配置
builder.Services.AddConfigurationOptions(builder.Configuration);

// 再添加认证服务
builder.Services.AddAuthenticationService();

// ...其他配置
var app = builder.Build();

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