.NET Maui配置变更后如何重新加载依赖注入服务？

可行性说明 #

直接清空并重新注册DI服务不可行。.NET Maui默认使用的DI容器（由MauiAppBuilder构建的IServiceProvider）是不可变的，一旦调用Build()生成服务提供者后，无法修改已注册的服务集合，也不能通过重新注册替换原有服务实例。

正确实现方案：基于IOptionsMonitor的配置热重载 #

要实现配置修改后无需重启应用即可生效，推荐使用IOptionsMonitor<T>替代直接注入IConfiguration，同时调整配置加载逻辑支持文件监听。

步骤1：修改配置文件加载逻辑，支持热重载 #

首先将嵌入的appsettings.json转为可读写文件（嵌入资源无法在运行时修改），并配置配置构建器监听文件变化：

var builder = MauiApp.CreateBuilder();

// 获取appsettings.json的可读写路径
var configPath = Path.Combine(FileSystem.AppDataDirectory, "appsettings.json");

// 首次启动时从嵌入资源复制到可读写目录
if (!File.Exists(configPath))
{
    using var stream = Assembly.GetExecutingAssembly()
        .GetManifestResourceStream("MauiBlazorTestApp.appsettings.json");
    using var fileStream = File.Create(configPath);
    stream.CopyTo(fileStream);
}

// 构建配置并开启文件变化重载
var config = new ConfigurationBuilder()
    .SetBasePath(FileSystem.AppDataDirectory)
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .Build();
builder.Configuration.AddConfiguration(config);

步骤2：绑定配置模型并注册IOptions服务 #

先定义配置模型类：

public class MyConfig
{
    public FactoryConfig FactoryConfig1 { get; set; }
    public FactoryConfig FactoryConfig2 { get; set; }
}

public class FactoryConfig
{
    public string SomeType1 { get; set; }
    public string SomeType2 { get; set; }
}

然后在Program.cs中绑定配置并注册服务：

// 绑定配置模型到DI容器
builder.Services.Configure<MyConfig>(builder.Configuration.GetSection("MyConfig"));

// 保持原有服务注册逻辑
builder.Services.AddSingleton<IService1, Service1>();
builder.Services.AddSingleton<IService2, Service2>();   
builder.Services.AddTransient<Service3>();

return builder.Build();

步骤3：在服务中使用IOptionsMonitor获取实时配置 #

修改Service1，用IOptionsMonitor<MyConfig>替代IConfiguration，配置更新时会自动获取最新值：

public class Service1 : IService1
{
    private readonly IOptionsMonitor<MyConfig> _configMonitor;

    public Service1(IOptionsMonitor<MyConfig> configMonitor)
    {
        _configMonitor = configMonitor;
    }

    public void SomeMethod()
    {      
        // 获取最新配置实例
        var myConfig = _configMonitor.CurrentValue;
        // 使用配置逻辑...
    }
}

步骤4：处理UI修改后的配置保存 #

当用户通过仪表板修改配置后，将更新后的配置序列化保存到文件，触发配置重载：

// 示例：保存修改后的配置
public async Task SaveUpdatedConfig(MyConfig updatedConfig)
{
    var configPath = Path.Combine(FileSystem.AppDataDirectory, "appsettings.json");
    var json = JsonSerializer.Serialize(updatedConfig, new JsonSerializerOptions { WriteIndented = true });
    await File.WriteAllTextAsync(configPath, json);
}

若需动态替换服务实例的替代方案 #

如果需求不仅是配置更新，还需要替换整个服务实例（比如配置修改后需重新初始化服务），可以用以下两种方式：

方式1：工厂模式创建服务 #

注册服务时使用工厂方法，每次获取服务时根据最新配置生成实例：

builder.Services.AddTransient<IService1>(sp => 
{
    var currentConfig = sp.GetRequiredService<IOptionsMonitor<MyConfig>>().CurrentValue;
    return new Service1(currentConfig);
});

方式2：代理服务包装真实实例 #

创建代理类，内部持有可更新的服务实例，配置变化时自动替换：

public class Service1Proxy : IService1
{
    private IService1 _innerService;
    private readonly IOptionsMonitor<MyConfig> _configMonitor;

    public Service1Proxy(IOptionsMonitor<MyConfig> configMonitor)
    {
        _configMonitor = configMonitor;
        // 初始化初始服务实例
        _innerService = new Service1(_configMonitor.CurrentValue);
        // 监听配置变化，更新内部服务
        _configMonitor.OnChange(newConfig => 
        {
            _innerService = new Service1(newConfig);
        });
    }

    public void SomeMethod()
    {
        _innerService.SomeMethod();
    }
}

// 注册代理服务到DI
builder.Services.AddSingleton<IService1, Service1Proxy>();

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