.NET Core中使用NLog Provider时结构化日志失效问题求助

你遇到的结构化日志失效问题，大概率和初始化顺序、配置写法或者日志语句的使用方式有关，我来一步步帮你排查：

1. 修正NLog初始化顺序 #

你当前的初始化代码顺序存在问题，应该先加载NLog配置，再将NLog添加到LoggerFactory中，否则配置可能无法正确应用到日志提供者。调整后的代码如下：

// 先加载NLog配置文件
NLog.LogManager.LoadConfiguration("nlog.config");
// 再将NLog注册到LoggerFactory
var loggerFactory = serviceProvider.GetRequiredService<ILoggerFactory>();
loggerFactory.AddNLog();

或者更简洁的写法，直接通过AddNLog的重载加载配置：

var loggerFactory = serviceProvider.GetRequiredService<ILoggerFactory>();
loggerFactory.AddNLog(new NLogProviderOptions { ConfigFile = "nlog.config" });

2. 确保日志语句使用结构化写法 #

结构化日志依赖带命名占位符的日志调用，而非字符串拼接。正确的写法示例：

// 正确：用命名占位符传递结构化参数
logger.LogInformation("用户 {UserId} 完成登录操作", currentUser.Id);

错误的写法（无法识别结构化属性）：

// 错误：字符串拼接丢失结构化信息
logger.LogInformation($"用户 {currentUser.Id} 完成登录操作");

只有通过{占位符}的形式，NLog才能将参数解析为结构化的键值对。

3. 检查NLog配置文件（nlog.config） #

你的配置文件需要明确支持结构化日志输出，比如使用JsonLayout来生成结构化日志内容。以下是一个基础的控制台结构化日志配置示例：

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

  <targets>
    <!-- 用JsonLayout输出结构化日志到控制台 -->
    <target name="console" xsi:type="Console">
      <layout xsi:type="JsonLayout">
        <attribute name="timestamp" layout="${longdate}" />
        <attribute name="level" layout="${level}" />
        <attribute name="message" layout="${message}" />
        <!-- 包含所有结构化属性 -->
        <attribute name="properties" layout="${all-event-properties}" encode="false" />
      </layout>
    </target>
  </targets>

  <rules>
    <logger name="*" minlevel="Info" writeTo="console" />
  </rules>
</nlog>

如果是输出到文件，同样可以用JsonLayout生成结构化日志文件，确保结构化属性被正确捕获输出。

4. 确认依赖包版本兼容 #

确保你安装的NLog.Extensions.Logging包版本与.NET Core版本匹配，建议使用最新稳定版，避免版本不兼容导致的问题。可以通过NuGet包管理器更新到最新版本。

按照以上步骤调整后，你的结构化日志应该就能正常工作了。如果仍有问题，可以开启NLog内部日志（在nlog.config中添加<internalLogFile>节点），排查是否存在配置加载或解析错误。

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