使用PublishAOT时Microsoft.Extensions.Configuration值类型默认值异常

现象复现 #

你的代码在普通dotnet build后输出符合预期：

String1: Override1
String2: Value2
Int3: 443
Bool4: True

但使用dotnet publish -c Release -r win-x64 -p:PublishAot=true发布后，值类型的默认值被重置为类型初始值：

String1: Override1
String2: Value2
Int3: 0
Bool4: False

原因分析 #

这是.NET配置绑定在AOT场景下的实现逻辑差异导致的：

• 对于引用类型（如string），配置绑定器会先调用类的无参构造函数初始化所有属性，保留你设置的默认值，再用配置中的值覆盖对应属性。
• 对于值类型（如int、bool），AOT编译依赖的配置绑定源生成器，在生成绑定代码时没有保留你在属性上设置的默认值，而是直接使用值类型的默认初始值（int=0、bool=false）——源生成器默认认为值类型属性如果没有配置项，就应该用类型默认值，而非代码里显式设置的默认值。

解决方法 #

方法1：使用可空值类型

把值类型改为可空值类型，这样它们会被当作引用类型处理，绑定器会保留你设置的默认值：

class TypedConfig
{
    public string String1 { get; set; } = "Value1";
    public string String2 { get; set; } = "Value2";
    public int? Int3 { get; set; } = 443;
    public bool? Bool4 { get; set; } = true;
}

修改后重新发布，值类型的默认值就能正常保留。

方法2：手动补全默认值

如果无法修改配置类，可以在绑定后手动检查并赋值默认值：

var config = builder.Build().Get<TypedConfig>() ?? new TypedConfig();
// 仅当配置未覆盖时设置默认值
if (config.Int3 == 0) config.Int3 = 443;
if (!config.Bool4) config.Bool4 = true;

这种方法适合已有代码无法修改的场景，但需要逐个属性处理，相对繁琐。

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