.NET 6控制台应用中Configuration.GetSection()返回null问题求助

我在.NET 6控制台应用中尝试通过配置获取连接字符串，但调用Configuration.GetSection()始终返回null。该操作在Web API项目中使用IConfiguration却能正常获取对应值，相关代码示例如下：

控制台应用Program.cs #

class Program
{
    private static IHostBuilder CreateHostBuilder(string[] args)
    {
        var hostBuilder = Host.CreateDefaultBuilder(args)
            .ConfigureAppConfiguration((context, builder) =>
            {
                builder.Sources.Clear();
                var env = context.HostingEnvironment;
                var environmentName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
                builder.AddJsonFile($"appsettings.{environmentName}.json", optional: true, reloadOnChange: true)
                 .AddJsonFile("version.json", optional: true, reloadOnChange: true);
                builder.AddEnvironmentVariables();
            })
            .ConfigureServices((context, services) =>
            {
                // connection strings mysql
                var myConnection = context.Configuration.GetSection("myConnection").Value; //null returned here
                // rest of the logic...
            });
        return hostBuilder;
    }
}

appsettings.development.json #

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
 "ConnectionStrings": {
    "myConnection": "Server=localhost;Initial Catalog=Student;User ID=xxx;Password=xxx;"
  }
}

Web API项目Program.cs片段 #

public static void ConfigureServices(IServiceCollection services, IConfiguration configuration)
{
    var myConnection = configuration.GetSection("myConnection").Value; //value returned here

    services.AddDbContext<Context>(options => options.UseMySql(myConnection, ServerVersion.AutoDetect(myConnection)));  

    // etc...
}

问题原因 #

1. 配置路径错误：连接字符串在配置文件中嵌套在ConnectionStrings节点下，直接通过myConnection路径无法定位到对应值。Web API中能获取到大概率是配置结构不同，或实际使用了其他方法（如GetConnectionString）。
2. 配置源被清空：调用builder.Sources.Clear()会清除Host.CreateDefaultBuilder默认加载的基础配置源（如appsettings.json），若ASPNETCORE_ENVIRONMENT环境变量未设置，指定的环境配置文件也无法加载。
3. 环境变量获取逻辑问题：控制台应用默认不会设置ASPNETCORE_ENVIRONMENT变量，直接读取该变量可能返回空值，导致环境配置文件加载失败。

解决办法 #

1. 修正配置读取路径

推荐使用GetConnectionString扩展方法（专门用于读取ConnectionStrings节点下的配置），或指定完整节点路径：

// 方法1：使用GetConnectionString（推荐）
var myConnection = context.Configuration.GetConnectionString("myConnection");

// 方法2：指定完整节点路径
var myConnection = context.Configuration.GetSection("ConnectionStrings:myConnection").Value;

2. 调整配置源加载逻辑

若无需清空默认配置源，直接移除builder.Sources.Clear()；若必须清空，需确保加载基础的appsettings.json，并使用宿主环境的环境名：

.ConfigureAppConfiguration((context, builder) =>
{
    // 非必要不要清空默认配置源，若需清空则保留下面的加载逻辑
    // builder.Sources.Clear();
    var env = context.HostingEnvironment;
    // 先加载基础配置文件，再加载环境特定配置
    builder.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
           .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: true)
           .AddJsonFile("version.json", optional: true, reloadOnChange: true)
           .AddEnvironmentVariables();
})

3. 设置控制台应用的环境变量

在控制台项目的调试设置中添加DOTNET_ENVIRONMENT或ASPNETCORE_ENVIRONMENT变量，值设为Development，确保环境配置文件能被正确加载。

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