NLog.config或app.config配置XML格式日志失败问题排查

核心问题拆解 #

你碰到的两个关键报错：

• configSections元素未处于configuration根节点的第一个位置，导致配置初始化失败
• 系统无法定位到NLog.config等配置文件

具体修复步骤 #

1. 修正app.config的节点顺序 #

如果把NLog配置写在app.config里，必须保证configSections是configuration的第一个子元素，示例正确结构如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <!-- 必须放在最开头，不能被其他节点前置 -->
  <configSections>
    <section name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>
  </configSections>

  <!-- 其他配置节点（如appSettings、connectionStrings）放在configSections之后 -->
  <appSettings>
    <!-- 你的自定义配置 -->
  </appSettings>

  <!-- NLog配置内容 -->
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <targets>
      <target name="file" xsi:type="File" 
              fileName="D:\output.log" 
              layout="${longdate} ${level} ${message}" />
    </targets>
    <rules>
      <logger name="*" minlevel="Debug" writeTo="file" />
    </rules>
  </nlog>
</configuration>

2. 确保独立NLog.config文件被正确识别 #

如果使用单独的NLog.config文件：

• 将文件放在程序的输出目录（比如Debug/Release文件夹，不是项目根目录）
• 在Visual Studio中选中该文件，右键修改属性：
  • 复制到输出目录：选择如果较新则复制或始终复制
  • 生成操作：选择内容

3. 验证日志路径与权限 #

• 检查NLog配置里的fileName路径格式是否正确，比如D盘根目录的路径要写为D:\your-log-name.log
• 确保程序有目标路径的写入权限，Windows系统下可尝试以管理员身份运行控制台程序

4. 确认NLog包版本兼容 #

保证安装的NLog相关包（如NLog、NLog.Config）和你的.NET版本匹配，避免版本不兼容导致的配置加载异常

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