如何在.NET Minimal API的Program.cs中无警告使用appsettings.json

核心问题分析 #

你当前代码触发ASP0000警告的原因是：builder.Services.BuildServiceProvider()会创建一个独立的服务容器实例，和后续builder.Build()生成的最终应用容器不是同一个，导致单例服务被重复实例化，既浪费资源又可能引发配置不一致问题。

最佳实践方案 #

1. 直接绑定配置实例，跳过提前构建服务容器

不需要通过DI容器获取配置，直接从IConfiguration中绑定强类型实例，同时保留IOptions<T>的注册供服务注入使用，完全规避警告。

示例代码：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();

// 1. 直接从配置节绑定强类型实例，用于Program.cs内直接使用
var mySettings = builder.Configuration
    .GetSection(MYSettingFromAppsettings.Position)
    .Get<MYSettingFromAppsettings>() 
    ?? throw new InvalidOperationException($"未找到配置节 {MYSettingFromAppsettings.Position}");

// 2. 注册IOptions<T>，供业务服务通过依赖注入使用
builder.Services.Configure<MYSettingFromAppsettings>(
    builder.Configuration.GetSection(MYSettingFromAppsettings.Position));

// 3. （可选）如果需要让服务直接注入MYSettingFromAppsettings而非IOptions<MYSettingFromAppsettings>
// 直接用已绑定的实例注册单例，避免通过服务解析器获取
builder.Services.AddSingleton(mySettings);

// --- 在Program.cs中直接使用配置 ---
// 比如配置CORS
builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowedOrigins", policy =>
    {
        policy.WithOrigins(mySettings.AllowedOrigins);
    });
});

var app = builder.Build();
// 后续中间件、端点配置...

2. 简化多配置类的绑定逻辑（可选）

如果有大量配置类，可以封装扩展方法减少重复代码：

public static class ConfigurationExtensions
{
    public static T BindConfig<T>(this IServiceCollection services, IConfiguration config, string sectionName)
        where T : class, new()
    {
        var settings = config.GetSection(sectionName).Get<T>() 
            ?? throw new InvalidOperationException($"配置节 {sectionName} 未配置或无效");
        
        // 注册IOptions<T>供服务注入
        services.Configure<T>(config.GetSection(sectionName));
        // 注册单例供直接注入（可选）
        services.AddSingleton(settings);
        
        return settings;
    }
}

在Program.cs中调用：

var mySettings = builder.Services.BindConfig<MYSettingFromAppsettings>(builder.Configuration, MYSettingFromAppsettings.Position);
var dbSettings = builder.Services.BindConfig<DatabaseSettings>(builder.Configuration, DatabaseSettings.Position);

3. 避免不必要的单例注册

如果业务服务只需要通过IOptions<MYSettingFromAppsettings>注入配置，那么完全不需要额外注册AddSingleton<MYSettingFromAppsettings>，仅保留Configure<TOptions>和Program.cs内直接绑定的实例即可。

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