.NET Core 3.1读取YAML配置异常：Section值与子节点表现异常

问题根源 #

你遇到的核心问题是当前使用的YAML配置加载逻辑没有适配.NET的IConfiguration系统。JSON是.NET配置系统原生支持的格式，会自动把嵌套结构解析为层级化的配置节点，所以GetSection("SomeSection")返回的是包含子节点的配置节，Value为null，GetChildren()能正常拿到子项。

但你现在的YAML加载方式，是把SomeSection对应的YAML对象直接序列化成了一个字符串（那个map[SomeKey:SomeValue]是Go风格的map字符串表示，说明你大概率用了非.NET生态的YAML工具，或者错误地把YAML内容当成单一值塞进了配置系统），导致IConfiguration把它识别成普通字符串值，而非层级配置节，所以GetChildren()返回空数组。

解决方案 #

1. 安装适配IConfiguration的YAML配置包 #

针对.NET Core 3.1，推荐用专门适配配置系统的YAML包，比如Microsoft.Extensions.Configuration.Yaml（对应3.1版本）或者YamlDotNet.Configuration：

# 安装Microsoft官方适配包
Install-Package Microsoft.Extensions.Configuration.Yaml -Version 3.1.0

# 或者用YamlDotNet的适配包
Install-Package YamlDotNet.Configuration -Version 5.0.0

2. 正确配置主机加载YAML文件 #

在Program.cs的CreateHostBuilder方法中，添加YAML配置源，和JSON配置的加载逻辑对齐：

用Microsoft.Extensions.Configuration.Yaml的示例：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            // 添加基础YAML配置文件
            config.AddYamlFile("appsettings.yml", optional: true, reloadOnChange: true);
            // 按需添加环境特定的YAML文件
            config.AddYamlFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.yml", optional: true);
            
            // 保留命令行等其他配置源
            config.AddCommandLine(args);
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

用YamlDotNet.Configuration的示例：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            config.AddYamlDotNetFile("appsettings.yml", optional: true, reloadOnChange: true);
            config.AddYamlDotNetFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.yml", optional: true);
            config.AddCommandLine(args);
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

3. 验证使用逻辑 #

配置完成后，YAML文件写法保持正常嵌套即可：

SomeSection:
  SomeKey: SomeValue

此时代码调用逻辑会和JSON配置表现完全一致：

var section = Configuration.GetSection("SomeSection");
Console.WriteLine(section.Value); // 返回null（因为这是配置节而非单一值）
var children = section.GetChildren().ToArray(); // 能拿到SomeKey对应的子节点
foreach (var child in children) 
{
    Console.WriteLine($"{child.Key}: {child.Value}"); // 输出SomeKey: SomeValue
}

额外提醒 #

如果你之前是手动读取YAML文件、把序列化后的字符串直接作为值添加到配置系统，这种方式是错误的。必须使用专门的配置提供者，它会自动把YAML结构解析为IConfiguration的层级节点，和JSON配置的处理逻辑对齐。

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