.NET 6中NLog自定义异步目标如何注入IHttpClientFactory？

问题原因 #

NLog默认通过反射实例化自定义目标，要求目标类必须提供无参构造函数。直接给SplunkTarget添加带IHttpClientFactory的构造函数，会导致NLog无法自动创建实例，从而抛出MissingMethodException。

解决方案 #

要让NLog使用ASP.NET Core的依赖注入容器来获取自定义目标实例，而非自行创建，具体步骤如下：

1. 保留SplunkTarget的构造函数注入 #

无需添加无参构造，保持依赖注入的构造函数：

private readonly IHttpClientFactory _clientFactory;

public SplunkTarget(IHttpClientFactory clientFactory)
{
    _clientFactory = clientFactory;
}

2. 将自定义目标注册到DI容器 #

在ConfigureServices中，把SplunkTarget注册为单例（日志目标通常采用单例生命周期）：

services.AddSingleton<SplunkTarget>();

IHttpClientFactory在ASP.NET Core中默认已自动注册，若需自定义HttpClient配置可添加services.AddHttpClient(...)扩展。

3. 手动构建NLog配置并注入目标 #

不要让NLog从配置文件自动创建目标，而是从DI容器中获取SplunkTarget实例，手动添加到NLog配置里：

public void ConfigureServices(IServiceCollection services)
{
    // 注册HttpClientFactory（默认已注册，可省略；如需自定义配置则添加）
    services.AddHttpClient();

    // 注册自定义SplunkTarget到DI容器
    services.AddSingleton<SplunkTarget>();

    // 配置日志系统
    services.AddLogging(loggingBuilder =>
    {
        loggingBuilder.ClearProviders();
        loggingBuilder.SetMinimumLevel(LogLevel.Trace);

        // 从DI容器中获取预注入的SplunkTarget实例
        var serviceProvider = services.BuildServiceProvider();
        var splunkTarget = serviceProvider.GetRequiredService<SplunkTarget>();

        // 构建NLog配置并添加日志规则
        var nLogConfig = new NLog.Config.LoggingConfiguration();
        // 配置规则：指定日志级别范围、目标实例、匹配的日志名称（*表示所有）
        nLogConfig.AddRule(LogLevel.Debug, LogLevel.Fatal, splunkTarget, "*");

        // 应用NLog配置
        LogManager.Configuration = nLogConfig;
        loggingBuilder.AddNLog(nLogConfig);
    });

    // 其他服务注册逻辑...
}

4. （可选）结合NLog.config配置 #

如果仍想保留NLog.config文件的基础配置，可以加载配置后替换目标实例：

// 加载NLog.config基础配置
var nLogConfig = new NLog.Config.XmlLoggingConfiguration("NLog.config");
// 移除配置中自动创建的SplunkTarget（若存在）
var existingTarget = nLogConfig.FindTargetByName("Splunk");
if (existingTarget != null)
{
    nLogConfig.RemoveTarget(existingTarget);
}
// 添加DI提供的SplunkTarget实例
nLogConfig.AddTarget("Splunk", splunkTarget);
// 重新绑定日志规则到新目标
nLogConfig.AddRule(LogLevel.Debug, LogLevel.Fatal, "Splunk", "*");

核心原理 #

通过将自定义目标纳入ASP.NET Core的DI管理，让NLog使用DI容器提供的实例，从而实现IHttpClientFactory的依赖注入，规避NLog因反射创建实例而要求无参构造的限制。

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