log4net配置文件怎么写？与NLog、Serilog对比及实用技巧全解析

一、log4net到底是什么？为什么至今仍被广泛使用？

log4net是Apache软件基金会旗下的开源日志组件，最初源自Java生态中大名鼎鼎的log4j。自2001年发布第一个版本以来，它已经在.NET世界里服务了超过二十年。很多老牌企业级项目，尤其是银行、保险、政务系统的后台，至今依然运行着基于log4net的日志模块。即便是在.NET Core和.NET 5+已经大行其道的今天，log4net仍然拥有庞大的存量用户群体。

为什么一个更新缓慢的老框架还有这么多人用？最核心的原因在于稳定性。日志组件运行在每一个请求的调用链路上，一旦出问题就会直接影响业务进程。log4net经过二十年的生产环境锤炼，各种边界情况、并发问题、文件锁冲突等坑基本都被踩平了，网上能搜到的解决方案也非常丰富。对于追求稳定大于新特性的传统行业来说，这种“老而可靠”的特质极具吸引力。

另一个不可忽视的因素是团队迁移成本。log4net的配置思想和API设计与Java的log4j一脉相承，如果团队同时维护Java和.NET两套系统，开发者可以在两种技术栈之间无缝切换认知。对于很多外包公司和传统企业来说，这种“一套知识，两处使用”的便利性，比引入一个新框架带来的学习成本要划算得多。

二、一份完整可用的log4net配置文件示例

2.1 配置文件放在哪里？

log4net的配置可以写在App.config、Web.config中，也可以单独放在一个名为log4net.config的文件里。如果使用独立文件，需要在程序启动时手动指定配置文件路径。如果写在App.config或Web.config里，则无需额外代码，程序启动时log4net会自动读取，这也是大多数项目的默认做法。

在App.config中，log4net的配置需要放在<configSections>节点中注册，并且<configSections>必须是<configuration>节点的第一个子节点，否则会报配置错误。这一点在手动编辑配置文件时需要特别注意。

2.2 完整示例代码

下面这份配置覆盖了最常见的需求：按日期滚动生成日志文件，同时输出到控制台。将文件放到App.config或Web.config中即可直接使用。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
  </configSections>
  <log4net>
    <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
      <file value="Logs\app.log" />
      <appendToFile value="true" />
      <rollingStyle value="Date" />
      <datePattern value="yyyyMMdd'.log'" />
      <maximumFileSize value="10MB" />
      <maxSizeRollBackups value="30" />
      <staticLogFileName value="false" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
      </layout>
    </appender>
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%date %-5level %message%newline" />
      </layout>
    </appender>
    <root>
      <level value="INFO" />
      <appender-ref ref="RollingFileAppender" />
      <appender-ref ref="ConsoleAppender" />
    </root>
  </log4net>
</configuration>

2.3 核心节点逐项拆解

appender节点是整个配置的核心。通俗地说，appender决定了“日志往哪里写”。上面示例中出现了两种appender：RollingFileAppender负责把日志写入文件，ConsoleAppender负责输出到控制台。每种appender都有自己的专属配置项，例如文件路径、滚动策略、编码格式等。

RollingFileAppender的关键属性需要仔细理解。file指定日志文件的基础路径和文件名。rollingStyle设为Date表示按日期滚动，每天生成一个新文件，配合datePattern使用。示例中datePattern为yyyyMMdd'.log'，意味着8月31日的日志会写到app_20260831.log这样的文件里。maximumFileSize和maxSizeRollBackups共同控制文件大小和备份数量，防止磁盘空间被日志占满。staticLogFileName设为false时，当前正在写入的日志文件名会带上日期后缀；如果设为true，则始终使用file属性指定的固定文件名。

layout节点定义了日志内容的格式。PatternLayout是最常用的布局器，通过conversionPattern指定输出模板。示例中的%date输出时间，[%thread]输出线程ID，%-5level输出级别（左侧补空格对齐到5个字符），%logger输出来源类的全名，%message输出日志正文，%newline换行。理解这些占位符的含义后，你完全可以按照自己的喜好定制日志格式。

root节点是日志的根级别配置。level定义了全局最低记录级别，示例中设为INFO，意味着DEBUG级别的日志将被忽略。appender-ref通过引用appender的name属性，将日志输出到对应的目的地。root节点中引用的appender对所有logger生效。

2.4 在代码中使用log4net

配置文件准备就绪后，代码部分非常简单。总共分三步：

第一步，在项目的AssemblyInfo.cs文件中添加一行特性声明：

[assembly: log4net.Config.XmlConfigurator(Watch = true)]

这行代码告诉log4net启动时读取配置文件，并且Watch = true表示监听配置文件的变化。程序运行期间如果修改了配置文件，log4net会立即重新加载，不需要重启应用。这个特性在排查生产问题时特别有用，后面会详细介绍。

第二步，在需要使用日志的类中获取logger实例：

public class OrderService
{
    private static readonly log4net.ILog log = 
        log4net.LogManager.GetLogger(typeof(OrderService));
}

第三部，调用logger的方法记录日志。log4net提供了五个级别的方法：Debug、Info、Warn、Error、Fatal。其中Error和Fatal方法支持传入异常对象，这里以记录一条下单操作的日志为例：

log.Info($"用户{userId}提交订单成功，订单号：{orderId}");
log.Error("数据库连接失败", ex);

所有方法调用完毕后，log4net会根据配置自动将日志写入对应的输出目标。业务代码中只需要调用方法，无需关心日志文件路径、格式等细节。

三、log4net与NLog、Serilog的全面对比

3.1 三者的定位差异

.NET生态中最常用的日志组件主要有三款：log4net、NLog和Serilog。从血统上看，log4net是Java log4j的移植作品，骨子里带着Java日志框架的基因；NLog是纯正的.NET原生产物，专门针对.NET平台的特性做过优化；Serilog则是新生代的代表，从一开始就把结构化日志作为核心卖点。

三者面对的问题和设计目标并不相同。log4net解决的是“有日志可用”的问题，它提供的配置体系和输出方式在当年已经非常完善。NLog在log4net的基础上做了大量简化，配置语法更简洁，性能和易用性都有提升。Serilog则面向的是现代应用对日志分析的需求，它输出的每一条日志都是一个结构化对象，可以直接被Elasticsearch、Seq等日志分析平台索引和查询。

3.2 多维度对比表格

3.3 表格之外的深层分析

从表格中可以看出，log4net的优势集中在成熟稳定、文档丰富、迁移成本低这几点。经过了近二十年的生产环境检验，它对于绝大多数常规场景已经完全够用。appender种类非常齐全，文件、控制台、数据库、事件日志、邮件、UDP远程日志等输出方式都有现成实现。过滤器机制也相当完善，可以基于级别、日志内容、正则表达式等条件精细控制日志是否输出。

但log4net的短板同样明显。最直观的问题是配置繁琐，一个简单的文件日志输出要写一大段XML，而且不同属性名的含义不够直观。其次是结构化日志能力的欠缺，这在现代日志分析体系中几乎是致命的。如果使用log4net输出结构化日志，需要自己在日志消息中拼装键值对，然后依赖日志分析平台的解析规则去提取字段，整个过程非常别扭。另外，.NET Core的原生支持需要借助log4net.Core适配包，官方更新节奏很慢，新特性基本停滞。

相比之下，NLog在易用性和性能之间找到了一个不错的平衡点。它的配置语法更简洁，同样的功能用NLog写起来的代码量比log4net少很多。内置的异步target可以很方便地提升高并发写入性能。Serilog则在日志分析场景中拥有绝对优势，它的结构化日志可以直接被Seq、Elasticsearch、Grafana Loki等平台消费，排查分布式系统的调用链时体验极佳。

四、log4net实战使用技巧

4.1 用异步缓冲提升高并发日志性能

默认情况下，log4net每记录一条日志就会同步执行一次IO操作。在请求量较高的Web应用中，这会对性能产生明显影响。解决方法是使用BufferingForwardingAppender，让日志先写入内存缓冲区，超过阈值后再批量写入磁盘文件。

<appender name="BufferingForwardingAppender" type="log4net.Appender.BufferingForwardingAppender">
  <bufferSize value="100" />
  <appender-ref ref="RollingFileAppender" />
</appender>

上面的配置会把日志先积攒到100条，然后一次性写入文件。这样能显著减少IO次数，提升整体吞吐量。但需要注意的是，缓冲带来的代价是实时性降低，而且如果程序在缓冲区未满时崩溃，这部分日志会丢失。因此，对于致命错误，建议单独使用一个不经过缓冲的appender，确保关键日志能立刻落盘。

4.2 按模块拆分日志文件

大型系统中把所有模块的日志混在一个文件里会带来严重的排查困难。比如订单模块的异常和用户模块的异常混在一起，排查问题时需要在海量日志中人工过滤，效率极低。

log4net支持通过logger节点为不同命名空间的类分别指定appender。例如为数据访问层单独设置一个logger：

<logger name="App.DataAccess">
  <level value="DEBUG" />
  <appender-ref ref="DataAccessFileAppender" />
</logger>

这样一来，命名空间以App.DataAccess开头的类产生的日志就会写入独立的文件。还可以设置additivity="false"，使这类日志不再向上传递到root节点的appender中，避免同一日志被重复写入多个文件。

4.3 异常日志必须带上完整堆栈

很多开发者在记录异常时只输出异常消息，这是日志记录中的大忌。例如log.Error(ex.Message)只能看到“对象引用未设置到实例”这类信息，完全无法定位问题发生的具体代码位置。

正确的做法是把exeception对象作为第二个参数传入：

log.Error("处理订单时发生异常", ex);

这样log4net会调用exception的ToString方法，将异常类型、完整堆栈、内部异常等全部信息写入日志。定位空引用、数据库连接失败、参数校验失败等问题时，堆栈信息是最高效的线索。

4.4 生产环境动态调整日志级别

把XmlConfigurator的Watch属性设为true后，修改配置文件中的level值，log4net会在几秒内自动重载配置。这个特性在排产环境排查问题时非常实用。

举个例子，某个接口线上报错，但现有INFO级别日志看不到足够的信息。这时可以把对应模块的logger临时改为DEBUG级别，访问配置文件，错误马上重现，DEBUG日志随之写入文件。排查完成后，将级别改回INFO即可。整个过程不需要重启Web服务器，不会影响在线用户的正常访问。

五、如何选择适合自己的日志框架？

选型没有绝对的对错，关键看项目所处的阶段和团队的技术背景。如果你是维护一个运行多年的老项目，现有代码中已经大量使用log4net，团队也习惯了它的写法，完全没有必要为了追新而替换。log4net的稳定性足以支撑核心生产环境，盲目迁移反而可能引入不必要的风险。

如果是全新启动的项目，尤其是基于.NET Core或.NET 5+的微服务架构，建议优先考虑Serilog。结构化日志带来的好处会在系统规模变大后逐渐显现，配合Seq或Elasticsearch做日志集中分析和告警时，体验天差地别。当然，Serilog的学习成本也相对高一些，团队需要理解结构化日志的概念，并统一日志字段规范。

NLog则是一个折中的好选择。它的配置思路和log4net相似，迁移成本低，但配置语法更简洁，性能也不错。对于大多数中小型Web应用来说，NLog已经完全够用，而且社区活跃度也不算低。

最后给正在使用log4net的团队两个建议：一是封装一个统一的日志门面层，让业务代码依赖自定义的ILogger接口，而不是直接依赖log4net。这样未来即使要更换底层实现，业务代码不需要改动。二是规范日志格式与级别使用，避免把INFO级别当成万能日志入口，让ERROR真正代表需要人工介入的异常情况，否则日志量过大反而会淹没真正有价值的错误信息。

掌握好这些配置技巧和设计思路，log4net依然是值得信赖的日志方案。希望这份指南能帮助你更好地驾驭它，让日志真正成为你排查问题的得力助手。

log4net配置文件示例log4net优势日志框架对比修改时间：2026-08-31 00:26:30