如何Mock IConfiguration.GetSection("foo").Get<Type>()？单元测试Settings为空问题

问题场景 #

• 定义POCO类Settings：

public class Settings
{
    public string Format { get; set; }
}

• appSettings.json配置：

"AppSettings": {
  "Format": "/^[0-9]*$/"
}

• Razor组件注入IConfiguration并初始化Settings：

[Inject]
public required IConfiguration Configuration { get; set; }

private Settings settings = new();

protected async override Task OnInitializedAsync()
{
    settings = Configuration.GetSection("AppSettings").Get<Settings>();
    await base.OnInitializedAsync();
}

• 点击事件中访问settings.Format时单元测试失败，提示settings为空，当前Mock方式：

Mock<Settings> mockSettings = new Mock<Settings>();

Mock<IConfiguration> mockConfig = new Mock<IConfiguration>();
mockConfig.Setup(m => m.GetSection(It.IsAny<string>()).Get<Settings>()).Returns(mockSettings.Object);

问题原因 #

Get<Settings>()是IConfigurationSection的扩展方法，Moq无法直接拦截扩展方法的调用逻辑。你之前的Mock试图拦截GetSection().Get<Settings>()的链式调用，但实际扩展方法不会被Moq的拦截逻辑捕获，导致settings始终为null。

正确解决方法 #

方法1：使用真实配置构建器（推荐，更接近生产场景） #

直接用ConfigurationBuilder构建内存中的测试配置，无需Mock：

// 构建测试用的内存配置
var testConfig = new ConfigurationBuilder()
    .AddInMemoryCollection(new Dictionary<string, string>
    {
        {"AppSettings:Format", "/^[0-9]*$/"}
    })
    .Build();

// 初始化组件并调用初始化方法
var component = new YourRazorComponentName
{
    Configuration = testConfig
};

await component.OnInitializedAsync();

这种方式完全模拟真实的配置读取逻辑，避免Mock复杂的配置接口。

方法2：Mock IConfigurationSection的底层行为 #

如果必须Mock，需要模拟GetSection返回的IConfigurationSection，并Setup扩展方法依赖的底层方法：

// 创建真实的Settings实例（POCO类无需Mock）
var testSettings = new Settings { Format = "/^[0-9]*$/" };

// Mock IConfigurationSection
var mockSection = new Mock<IConfigurationSection>();
// Setup GetValue方法，匹配"Format"键
mockSection.Setup(s => s.GetValue<string>(It.Is<string>(key => key == "Format")))
           .Returns(testSettings.Format);
// 必要的Section属性设置
mockSection.Setup(s => s.Key).Returns("AppSettings");
mockSection.Setup(s => s.Path).Returns("AppSettings");

// Mock IConfiguration，让GetSection返回上面的MockSection
var mockConfig = new Mock<IConfiguration>();
mockConfig.Setup(c => c.GetSection(It.Is<string>(name => name == "AppSettings")))
          .Returns(mockSection.Object);

// 初始化组件
var component = new YourRazorComponentName
{
    Configuration = mockConfig.Object
};

await component.OnInitializedAsync();

额外提示 #

• 对于简单的POCO类（如Settings），不需要Mock，直接使用真实实例即可，Mock只适用于接口或抽象依赖。
• 单元测试中务必调用OnInitializedAsync()，否则settings不会被初始化，这也是常见的错误点。

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