.NET Core中使用services.Configure时无法转换IConfigurationSection到Action<T>

问题描述 #

在ASP.NET Core应用中配置AWS设置时，尝试通过services.Configure将appsettings.json中的AWS配置绑定到AWSConfiguration实体类，出现编译错误：

Error CS1503: Argument 2: cannot convert from 'Microsoft.Extensions.Configuration.IConfigurationSection' to 'System.Action<Infrastructure.Aws.Configurations.AWSConfiguration>'

相关配置与代码如下：

appsettings.json配置段 #

"AWSConfiguration": {
    "AWSKey": "",
    "AWSSecretKey": "",
    "Region": "",
    "Bucket": {
      "Name": "",
      "Prefix": "",
      "Url": ""
    }
}

AWSConfiguration实体类定义 #

public class AWSConfiguration
{
    public string AWSKey { get; set; }
    public string AWSSecretKey { get; set; } 
    public string Region { get; set; } 
    public BucketConfiguration Bucket { get; set; } 
}

public class BucketConfiguration
{
    public string Name { get; set; } 
    public string Prefix { get; set; } 
    public string Url { get; set; }
}

服务注册代码 #

public static class InfrastructureServiceRegistration
{
    public static IServiceCollection AddInfrastructureServices(this IServiceCollection services, IConfiguration configuration)
    {
        services.Configure<AWSConfiguration>(configuration.GetSection("AWSConfiguration"));

        services.AddSingleton<IAmazonS3>(sp =>
        {
            var awsConfig = sp.GetRequiredService<IOptions<AWSConfiguration>>().Value;
            var region = Amazon.RegionEndpoint.GetBySystemName(awsConfig.Region);
            return new AmazonS3Client(awsConfig.AWSKey, awsConfig.AWSSecretKey, region);
        });

        services.AddSingleton<IFileStorageService, AWSFileStorageService>();

        return services;
    }
}

问题原因及解决方法 #

这个错误的核心原因是缺少Microsoft.Extensions.Options.ConfigurationExtensions NuGet包。services.Configure<T>(IConfigurationSection)这个重载方法并不包含在默认的Microsoft.Extensions.DependencyInjection包中，而是属于ConfigurationExtensions扩展包。

解决步骤：

1. 安装Microsoft.Extensions.Options.ConfigurationExtensions NuGet包：
   • 通过NuGet包管理器搜索安装
   • 或使用Package Manager Console命令：

     Install-Package Microsoft.Extensions.Options.ConfigurationExtensions
     

   • 或使用.NET CLI命令：

     dotnet add package Microsoft.Extensions.Options.ConfigurationExtensions
     

2. 在服务注册的代码文件顶部添加命名空间引用：

   using Microsoft.Extensions.Options;
   

完成以上操作后，services.Configure<AWSConfiguration>(configuration.GetSection("AWSConfiguration"))就能正确识别重载方法，完成配置绑定，编译错误会消失。

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