ASP.NET Core 2.1迁移至3.1时出现IOptions服务解析失败问题求助

1. 确认配置类与配置文件匹配 #

确保Web.Extensions.WebSettings类的属性和appsettings.json中的配置节字段完全对应，示例如下：

namespace Web.Extensions
{
    public class WebSettings
    {
        public string ApiBaseUrl { get; set; }
        public int RequestTimeout { get; set; }
    }
}

对应appsettings.json内容：

{
  "WebSettings": {
    "ApiBaseUrl": "https://your-api-domain.com",
    "RequestTimeout": 30
  }
}

2. 在Startup.cs中正确注册配置服务 #

在ConfigureServices方法中添加配置绑定代码，ASP.NET Core 3.1需明确指定配置节：

public void ConfigureServices(IServiceCollection services)
{
    // 绑定WebSettings配置
    services.Configure<WebSettings>(Configuration.GetSection("WebSettings"));
    
    // 其他服务注册（如MVC、Controllers等）
    services.AddControllersWithViews();
}

3. 修正Startup构造函数的依赖注入方式 #

禁止在Startup构造函数中直接注入IOptions<WebSettings>，需改为注入IConfiguration，若要使用配置可在Configure方法中注入：

// 正确的构造函数写法
public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public IConfiguration Configuration { get; }

// 在Configure方法中使用配置
public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IOptions<WebSettings> webSettings)
{
    var settings = webSettings.Value;
    // 业务逻辑处理
}

4. 确保配置文件被正确加载 #

如果使用自定义配置文件，需在Program.cs中明确添加加载逻辑：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((context, config) =>
        {
            // 添加自定义配置文件（可选）
            config.AddJsonFile("custom-settings.json", optional: true, reloadOnChange: true);
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

5. 清理缓存并重建项目 #

执行以下操作消除可能的编译缓存问题：

• 删除项目目录下的bin和obj文件夹
• 执行Visual Studio的「清理解决方案」操作
• 重新编译并运行项目

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