如何在DI容器中从多处注册多个Flurl客户端至单例IFlurlClientCache？

问题背景 #

Flurl官方文档推荐的依赖注入注册模式如下：

// 服务注册时：
services.AddSingleton<IFlurlClientCache>(sp => new FlurlClientCache()
    .Add("MyCli", "https://some-api.com"));

但这种方式仅适合在一处完成所有客户端注册的场景。如果不同库需要各自注册专属Flurl客户端，无法通过链式调用Add一次性完成缓存填充，就会遇到注册冲突——无法在多处代码中向同一个IFlurlClientCache单例添加客户端。

解决方案 #

方法一：扩展方法批量注册（推荐）

通过自定义扩展方法收集各库的客户端注册逻辑，最后统一初始化单例缓存，完美适配多库拆分场景：

1. 定义核心扩展工具类

public static class FlurlClientRegistrationExtensions
{
    private static readonly List<Action<IFlurlClientCache>> _clientConfigs = new();

    // 供各库调用，提交客户端注册逻辑
    public static void RegisterFlurlClient(this IServiceCollection services, Action<IFlurlClientCache> configAction)
    {
        _clientConfigs.Add(configAction);
    }

    // 在启动类中调用，完成单例缓存的最终初始化
    public static void AddFlurlClients(this IServiceCollection services)
    {
        services.AddSingleton<IFlurlClientCache>(sp =>
        {
            var cache = new FlurlClientCache();
            foreach (var config in _clientConfigs)
            {
                config(cache);
            }
            return cache;
        });
    }
}

2. 各库独立注册客户端
   比如订单模块的注册代码：

public static class OrderServiceExtensions
{
    public static void AddOrderServices(this IServiceCollection services)
    {
        // 注册订单API的Flurl客户端
        services.RegisterFlurlClient(cache => 
            cache.Add("OrderApi", "https://order-api.example.com"));
        
        // 其他订单服务注册逻辑...
    }
}

用户模块的注册代码：

public static class UserServiceExtensions
{
    public static void AddUserServices(this IServiceCollection services)
    {
        // 注册用户API的Flurl客户端
        services.RegisterFlurlClient(cache => 
            cache.Add("UserApi", "https://user-api.example.com"));
        
        // 其他用户服务注册逻辑...
    }
}

3. 启动类统一完成初始化

var builder = WebApplication.CreateBuilder(args);

// 先加载各模块的服务注册
builder.Services.AddOrderServices();
builder.Services.AddUserServices();

// 最后统一初始化Flurl客户端缓存
builder.Services.AddFlurlClients();

// ...其他启动逻辑

方法二：托管服务后置初始化

如果不想用静态集合，可利用ASP.NET Core的托管服务，在应用启动阶段向已注册的缓存实例添加客户端：

1. 先注册空的缓存单例

services.AddSingleton<IFlurlClientCache>(_ => new FlurlClientCache());

2. 各模块添加初始化托管服务
   订单模块示例：

public static class OrderServiceExtensions
{
    public static void AddOrderServices(this IServiceCollection services)
    {
        services.AddHostedService<OrderApiClientInitializer>();
        // 其他订单服务逻辑...
    }
}

internal class OrderApiClientInitializer : IHostedService
{
    private readonly IFlurlClientCache _clientCache;

    public OrderApiClientInitializer(IFlurlClientCache clientCache)
    {
        _clientCache = clientCache;
    }

    public Task StartAsync(CancellationToken cancellationToken)
    {
        _clientCache.Add("OrderApi", "https://order-api.example.com");
        return Task.CompletedTask;
    }

    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
}

用户模块同理，创建对应的UserApiClientInitializer即可。托管服务会在应用启动时自动执行，确保客户端在业务代码运行前完成注册。

注意事项 #

• 客户端名称（如"OrderApi"）必须全局唯一，避免不同模块注册同名客户端导致覆盖。
• 方法一中的静态集合如果涉及多线程注册场景，建议添加锁保护_clientConfigs的修改操作。

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