简介log4net 1.2.10是一套来自Apache软件基金会的.NET日志记录框架经典版本面向需要为应用程序添加调试、异常追踪与运行监控能力的.NET开发人员。这一资源同时包含源码和编译好的DLL文件既可在项目中直接引用也能通过阅读源码理解日志记录的核心设计。压缩包整体约6.79MB以C#源码与程序集文件为主轻量小巧便于携带和部署。该框架支持通过XML或代码声明式配置提供从DEBUG到FATAL的多级别日志控制并能将日志输出到文件、控制台、数据库、SMTP等不同目标同时具备良好的线程安全性与执行性能适合在ASP.NET、Windows服务、WPF及WinForms等典型场景中使用。借助这一资源开发者可以快速搭建统一日志体系利用自定义Appender与Layout实现特殊格式需求还能在调试定位、性能分析、异常捕获、系统监控以及审计合规等方面发挥实际作用。目前已有269人学习下载对于希望深入掌握日志框架原理或快速落地日志方案的.NET工程师来说是一份参考价值明确的学习资源。 如果你在某个老项目的packages目录里看到log4net-1.2.10这个名字大概率会停下来犹豫一下换掉吧怕有一堆兼容问题不换吧又觉得版本老得拿不出手。我这几个月接手一套 .NET Framework 老系统日志库里就是 log4net 1.2.10。很多人觉得 log4net 不过是“写日志的库”但它在项目里的角色更像一套日志基础设施谁写日志、写到哪、按什么格式、什么时候滚动、什么级别能过全都在配置里定义。这篇文章围绕 log4net 1.2.10 的实际使用场景把配置搭建、Appender 选型、排障和升级思路一次理清适合正在维护老项目的人也适合想搞懂 log4net 底层模型的开发者。1. 拆开 log4net 的底层逻辑Logger、Appender、Layout 的分工1.1 Logger 与日志级别先想清楚你要记录什么在 log4net 的模型里一次日志请求要经过“级别判断 → Logger 继承链 → Appender 输出 → Layout 格式化”。Logger 是开发人员最先接触的入口通常写成private static readonly ILog log LogManager.GetLogger(typeof(Program));这里的typeof(Program)会变成 Logger 的名字后续在 Layout 里用%logger输出的就是这个名字。别小看它Logger 的命名方式是点分结构比如MyApp.Business.OrderService这直接影响日志路由和级别控制。log4net 1.2.10 提供五档级别DEBUG、INFO、WARN、ERROR、FATAL另外还有ALL和OFF两个总开关。判断规则是只有当日志事件的级别大于等于当前 Logger 配置的级别时日志才会被输出。比如 Logger 级别是WARN那么log.Info(...)会被直接丢弃不会进入任何 Appender。这里有一个实操心得不要在日志调用里做字符串拼接比如log.Info(user userId)。如果当前级别不满足log4net 虽然不会输出但字符串拼接已经执行了白白浪费 CPU。正确做法是用级别开关先判断if (log.IsInfoEnabled) { log.InfoFormat(user{0}, userId); }在日志量大的业务里这个习惯能省下不少开销。1.2 Appender决定日志的最终去向Appender 是 log4net 的输出目标。日志最终写到控制台、文件、数据库还是邮件告警完全由 Appender 决定。根节点root可以挂多个 Appender不同 Logger 也可以独立挂不同的 Appender互不影响。我经常把 Appender 比作水管Logger 是水龙头Appender 是水管末端接的水桶。同一个水龙头可以分流到多个水桶一个水桶也可以服务多个水龙头。理解了这个后面遇到“日志重复输出”时就能反应过来大概率是添加性设置的问题。1.2.10 里常见的 Appender 包括FileAppender、RollingFileAppender、ConsoleAppender、AdoNetAppender、SmtpAppender、MemoryAppender、EventLogAppender等。它们各自独立配置也可以组合挂载。1.3 Layout决定日志长什么样Layout 负责把日志事件格式化成文本。最常用的是PatternLayout里面的转换模式参数项不少但核心就几个%date、%thread、%-5level、%logger、%message、%newline、%exception。在实际维护中我建议把这条固定格式作为团队默认%date [%thread] %-5level %logger - %message%newline输出效果类似2025-06-15 10:00:00,123 [5] INFO MyApp.Program - application started这样时间、线程、级别、来源、消息一应俱全排查问题时一眼就能定位。如果要在日志里带请求号、用户 ID 这类上下文信息可以用ThreadContext或GlobalContext写入再通过%property{key}取出来。1.4 为什么老项目会锁在 1.2.10这个版本是 .NET Framework 2.0 时代的稳定产物当时很多遗留系统为了“少一个强名称冲突”长期锁版本。1.2.10 依赖极少直接引用 dll 就能跑所以老系统里到处都能看到它的身影。它不是性能天花板但作为日志基础件足够稳。真正的问题往往不在于框架本身而在于配置和运维习惯。2. 三步跑通最小配置引用、注册、写第一行日志2.1 引用方式与 configSections 注册老项目没有 NuGet 的情况很常见。直接引用packages/log4net-1.2.10/lib/2.0/log4net.dll是最直接的方式。如果项目用 NuGet也可以安装log4net1.2.10 版本但要注意目标框架是 .NET Framework 2.0 还是 4.x不同框架选对应兼容版本。如果 log4net 配置写在app.config或web.config里必须在configuration节点的第一个位置注册 sectionconfiguration configSections section namelog4net typelog4net.Config.Log4NetConfigurationSectionHandler, log4net / /configSections /configurationconfigSections必须是configuration下的第一个子节点放错位置会直接报配置错误。这是新手最容易踩的坑。如果不想污染web.config更推荐用独立的log4net.config文件。独立文件不需要注册 configSections根节点直接写log4net就行好处是修改日志配置不会触发 Web 应用重启。这个细节在老项目里很重要。2.2 最小配置文件下面是一份能直接跑起来的最小配置生产环境也够用log4net root level valueINFO / appender-ref refRollingFileAppender / /root appender nameRollingFileAppender typelog4net.Appender.RollingFileAppender file valueLogs/app- / appendToFile valuetrue / rollingStyle valueDate / datePattern valueyyyyMMdd.log / staticLogFileName valuefalse / layout typelog4net.Layout.PatternLayout conversionPattern value%date [%thread] %-5level %logger - %message%newline / /layout /appender /log4net说明几个关键点file valueLogs/app- /是日志文件前缀datePattern里的yyyyMMdd会拼在文件名后面所以每天会生成app-20250615.log这样的文件。datePattern中的点号.log用单引号包住目的是让点号原样输出否则可能被当成特殊格式处理。这是我实际踩过的坑。staticLogFileName valuefalse /表示活动日志文件名也带日期保证当天文件是唯一的。确保Logs目录存在log4net 不会主动创建多层目录目录不存在时可能会静默失败。2.3 初始化代码的三种写法第一种在程序集上添加特性[assembly: log4net.Config.XmlConfigurator(ConfigFile log4net.config, Watch true)]第二种在入口方法或Application_Start里手动加载log4net.Config.XmlConfigurator.Configure(new FileInfo(log4net.config));第三种直接在程序集特性里不写ConfigFile默认从app.config读取log4net节点。我推荐手动Configure因为它最可控不会出现“配置到底加载了没有”的模糊状态。Watch true虽然能监视配置文件修改后自动重载但生产环境不建议频繁改日志配置触发重载反而影响稳定性。3. Appender 选型、Layout 调参与最佳组合3.1 按场景选 Appender用 log4net 这么多年我总结了一套按场景选择 Appender 的表格可以直接抄需求推荐 Appender说明本地调试ConsoleAppender输出到控制台开发时最直观单文件追加FileAppender日志量小或临时任务按天/按大小滚动RollingFileAppender生产环境首选日志入库分析AdoNetAppender批量写入减少对业务线程的影响错误邮件告警SmtpAppenderERROR 以上级别发邮件内存缓冲BufferingForwardingAppender合并日志事件降低 IO 和锁竞争单元测试断言MemoryAppender在测试代码里检查日志事件SmtpAppender要慎用。邮件通道本身可能阻塞如果 SMTP 服务器响应慢业务线程会被拖住。AdoNetAppender也有类似问题如果数据库挂了业务日志会跟着丢。这两种 Appender 都应该在前期做压测别等生产环境出问题再后悔。3.2 RollingFileAppender 参数细节RollingFileAppender 是生产环境的主角参数配置有几个容易混淆的地方rollingStyleDate表示按日期滚动Size表示按大小滚动Composite同时支持两者。想要“每天一个文件且单个文件不超过 10MB”必须用Composite。maximumFileSize默认 10MB配合maxSizeRollBackups可以控制历史文件数量。appendToFile如果设为false进程重启时会覆盖旧日志这个选项一般保持true。staticLogFileName为true时当前日志文件始终叫同一名字滚动后旧文件改名为false时当前文件名直接带日期或序号。还有锁定模型。默认ExclusiveLock只允许一个进程写同一个文件如果多个进程需要共享日志文件可以改成MinimalLocklockingModel typelog4net.Appender.FileAppenderMinimalLock /但这会让每次写入都经历一次开锁解锁吞吐量明显下降只适合低频场景。我维护过一个定时任务和一个 Web 站点共用日志文件的项目实在避不开才用MinimalLock。3.3 PatternLayout 常用参数表参数含义示例输出%date{ISO8601}时间戳2025-06-15 10:00:00,123%thread线程编号5%-5level左对齐级别INFO%loggerLogger 名称MyApp.Program%message日志消息application started%newline换行换行%exception异常堆栈完整异常信息%property{key}上下文属性自定义值%class和%file这类参数能输出调用类名和文件名但需要加载调试信息会影响性能生产环境不建议加。3.4 同时写文件和控制台的组合开发阶段想同时在控制台看到日志生产环境写文件最简单的方式是在root下挂两个 appender-refroot level valueINFO / appender-ref refConsoleAppender / appender-ref refRollingFileAppender / /root如果不同业务模块要写到不同文件比如订单日志和登录日志分开就需要用logger节点独立配置。这时很多人会遇到“一条日志出现在多个文件”的问题原因是子 Logger 默认继续向父 Logger 的 Appender 输出这就是 additivity。解决办法是在独立配置的logger节点上加logger nameMyApp.Order level valueINFO / appender-ref refOrderFileAppender / additivity valuefalse / /loggeradditivityfalse表示这条日志不再向上级 Logger 的 Appender 传递能有效避免重复写入。4. 高频故障排障日志不落盘、重复输出、滚动失效4.1 日志文件压根没生成这是出现频率最高的问题。排查顺序我基本固定为log4net 配置是写在app.config里还是独立文件里写在app.config但没注册configSections大概率不会加载。有没有真正执行初始化程序集特性是否写在了入口程序集上如果 log4net 是从类库里调用而特性写在另一个程序集初始化时机可能不对。目录权限是否足够Windows 服务默认账户可能没有用户目录写权限IIS 应用池也要给日志目录写权限。配置文件是不是有 XML 格式错误log4net 很多配置错误是静默吞掉的不会抛异常。排查技巧在log4net根节点加debugtruelog4net 会把内部诊断信息输出到调试器或控制台很快能看到配置加载过程中的异常。4.2 一条日志被写进多个文件这个现象通常不是 bug而是 additivity 的默认行为。对additivity的理解不深就会觉得 log4net 疯了。解决思路是检查 Logger 命名层次根节点挂了文件某个业务命名空间又挂了自己的文件那么这个命名空间下的日志就可能出现两份。按前面说的在logger节点加additivity valuefalse /即可。4.3 日志文件不滚动滚动失效有三个高频原因rollingStyle配成Date但datePattern没达到滚动条件。Date模式要跨天才会创建新文件如果只是当天调试看不到滚动是正常的。既想按日期又想按大小滚动却只用Date模式maximumFileSize不会生效。这时候要用Composite。staticLogFileNametrue时滚动文件被改名为带历史后缀的文件你以为没滚动其实旧文件已经被改名了。想让当天文件直接带日期就把staticLogFileName设为false。4.4 日志把磁盘写满日期滚动不等于自动删除旧文件。maxSizeRollBackups在Date模式下并不绝对保证清理逻辑生产环境必须靠运维脚本兜底比如定期清理 N 天前的日志文件。1.2.10 没有内置保留天数策略这是很多新版本也未必解决的问题所以日志清理一定要纳入日常运维检查。4.5 高并发下日志性能下降1.2.10 的 Appender 默认是同步执行的。日志量一旦上去文件锁竞争会变成瓶颈。如果不想改代码可以用BufferingForwardingAppender把日志事件缓冲起来批量转发给真正的输出 Appender。但要注意缓冲意味着应用崩溃时可能丢失最近的一部分日志这个取舍需要业务方来决定。5. 如果要离开 1.2.10升级前需要算清的账5.1 新版 log4net 与 1.2.10 的差异新版 log4net 已经覆盖 .NET Standard 2.0跨平台能力更强。配置文件结构基本兼容但程序集版本和强名称有变化直接替换 dll 可能触发Could not load file or assembly错误通常需要配置 bindingRedirect 才能加载成功。RollingFileAppender 在后续版本中的底层处理也有所调整部分参数的含义更严格。升级后不要想当然地配置一次就完事必须跑一轮测试重点验证日期滚动、文件名后缀和异常堆栈输出。另外要有个预期新版依然没有内置的异步 Appender异步写入要靠自己封装第三方扩展组件不要指望升级就能自动解决性能问题。5.2 我的迁移顺序如果项目还在 .NET Framework且不是完全没有升级空间我建议按下面顺序操作用 NuGet 替换原来的 dll 引用选择一个长期维护的稳定版本例如 log4net 2.0.x 系列。在app.config中确认 bindingRedirect 正确避免运行时加载旧版本程序集。启动时写一条DEBUG、一条INFO、一条ERROR测试日志检查文件生成、滚动和异常堆栈。用日志量压测一下写入吞吐评估要不要加BufferingForwardingAppender。上线前关闭内部诊断日志级别从DEBUG收紧到INFO或WARN。5.3 真正不能升级的项目怎么办有些项目因为 .NET Framework 2.0 限制、老服务器环境或第三方依赖锁死实在无法离开 1.2.10。这种情况下我的建议是别硬升级重点做好运维管理每天确认日志是否正常滚动、目录权限和磁盘空间是否足够、日志级别不要设在DEBUG除非临时抓问题。我维护过的一套老系统至今锁在 1.2.10只要配置不动它跑起来非常省心。最后分享一个我在实际排查中的土办法log4net 这类组件出问题时先别看业务代码先确认日志配置到底有没有被加载。只要看到LogManager.GetRepository().Configured的结果是true再顺着 Appender 往下查基本半小时内能定位。1.2.10 年纪不小但我一直觉得它是那个年代最稳定的日志层之一配置一次能安静跑很多年。本文还有配套的精品资源点击获取 log4net 1.2.10 实战指南：配置、Appender与排障要点
简介log4net 1.2.10是一套来自Apache软件基金会的.NET日志记录框架经典版本面向需要为应用程序添加调试、异常追踪与运行监控能力的.NET开发人员。这一资源同时包含源码和编译好的DLL文件既可在项目中直接引用也能通过阅读源码理解日志记录的核心设计。压缩包整体约6.79MB以C#源码与程序集文件为主轻量小巧便于携带和部署。该框架支持通过XML或代码声明式配置提供从DEBUG到FATAL的多级别日志控制并能将日志输出到文件、控制台、数据库、SMTP等不同目标同时具备良好的线程安全性与执行性能适合在ASP.NET、Windows服务、WPF及WinForms等典型场景中使用。借助这一资源开发者可以快速搭建统一日志体系利用自定义Appender与Layout实现特殊格式需求还能在调试定位、性能分析、异常捕获、系统监控以及审计合规等方面发挥实际作用。目前已有269人学习下载对于希望深入掌握日志框架原理或快速落地日志方案的.NET工程师来说是一份参考价值明确的学习资源。 如果你在某个老项目的packages目录里看到log4net-1.2.10这个名字大概率会停下来犹豫一下换掉吧怕有一堆兼容问题不换吧又觉得版本老得拿不出手。我这几个月接手一套 .NET Framework 老系统日志库里就是 log4net 1.2.10。很多人觉得 log4net 不过是“写日志的库”但它在项目里的角色更像一套日志基础设施谁写日志、写到哪、按什么格式、什么时候滚动、什么级别能过全都在配置里定义。这篇文章围绕 log4net 1.2.10 的实际使用场景把配置搭建、Appender 选型、排障和升级思路一次理清适合正在维护老项目的人也适合想搞懂 log4net 底层模型的开发者。1. 拆开 log4net 的底层逻辑Logger、Appender、Layout 的分工1.1 Logger 与日志级别先想清楚你要记录什么在 log4net 的模型里一次日志请求要经过“级别判断 → Logger 继承链 → Appender 输出 → Layout 格式化”。Logger 是开发人员最先接触的入口通常写成private static readonly ILog log LogManager.GetLogger(typeof(Program));这里的typeof(Program)会变成 Logger 的名字后续在 Layout 里用%logger输出的就是这个名字。别小看它Logger 的命名方式是点分结构比如MyApp.Business.OrderService这直接影响日志路由和级别控制。log4net 1.2.10 提供五档级别DEBUG、INFO、WARN、ERROR、FATAL另外还有ALL和OFF两个总开关。判断规则是只有当日志事件的级别大于等于当前 Logger 配置的级别时日志才会被输出。比如 Logger 级别是WARN那么log.Info(...)会被直接丢弃不会进入任何 Appender。这里有一个实操心得不要在日志调用里做字符串拼接比如log.Info(user userId)。如果当前级别不满足log4net 虽然不会输出但字符串拼接已经执行了白白浪费 CPU。正确做法是用级别开关先判断if (log.IsInfoEnabled) { log.InfoFormat(user{0}, userId); }在日志量大的业务里这个习惯能省下不少开销。1.2 Appender决定日志的最终去向Appender 是 log4net 的输出目标。日志最终写到控制台、文件、数据库还是邮件告警完全由 Appender 决定。根节点root可以挂多个 Appender不同 Logger 也可以独立挂不同的 Appender互不影响。我经常把 Appender 比作水管Logger 是水龙头Appender 是水管末端接的水桶。同一个水龙头可以分流到多个水桶一个水桶也可以服务多个水龙头。理解了这个后面遇到“日志重复输出”时就能反应过来大概率是添加性设置的问题。1.2.10 里常见的 Appender 包括FileAppender、RollingFileAppender、ConsoleAppender、AdoNetAppender、SmtpAppender、MemoryAppender、EventLogAppender等。它们各自独立配置也可以组合挂载。1.3 Layout决定日志长什么样Layout 负责把日志事件格式化成文本。最常用的是PatternLayout里面的转换模式参数项不少但核心就几个%date、%thread、%-5level、%logger、%message、%newline、%exception。在实际维护中我建议把这条固定格式作为团队默认%date [%thread] %-5level %logger - %message%newline输出效果类似2025-06-15 10:00:00,123 [5] INFO MyApp.Program - application started这样时间、线程、级别、来源、消息一应俱全排查问题时一眼就能定位。如果要在日志里带请求号、用户 ID 这类上下文信息可以用ThreadContext或GlobalContext写入再通过%property{key}取出来。1.4 为什么老项目会锁在 1.2.10这个版本是 .NET Framework 2.0 时代的稳定产物当时很多遗留系统为了“少一个强名称冲突”长期锁版本。1.2.10 依赖极少直接引用 dll 就能跑所以老系统里到处都能看到它的身影。它不是性能天花板但作为日志基础件足够稳。真正的问题往往不在于框架本身而在于配置和运维习惯。2. 三步跑通最小配置引用、注册、写第一行日志2.1 引用方式与 configSections 注册老项目没有 NuGet 的情况很常见。直接引用packages/log4net-1.2.10/lib/2.0/log4net.dll是最直接的方式。如果项目用 NuGet也可以安装log4net1.2.10 版本但要注意目标框架是 .NET Framework 2.0 还是 4.x不同框架选对应兼容版本。如果 log4net 配置写在app.config或web.config里必须在configuration节点的第一个位置注册 sectionconfiguration configSections section namelog4net typelog4net.Config.Log4NetConfigurationSectionHandler, log4net / /configSections /configurationconfigSections必须是configuration下的第一个子节点放错位置会直接报配置错误。这是新手最容易踩的坑。如果不想污染web.config更推荐用独立的log4net.config文件。独立文件不需要注册 configSections根节点直接写log4net就行好处是修改日志配置不会触发 Web 应用重启。这个细节在老项目里很重要。2.2 最小配置文件下面是一份能直接跑起来的最小配置生产环境也够用log4net root level valueINFO / appender-ref refRollingFileAppender / /root appender nameRollingFileAppender typelog4net.Appender.RollingFileAppender file valueLogs/app- / appendToFile valuetrue / rollingStyle valueDate / datePattern valueyyyyMMdd.log / staticLogFileName valuefalse / layout typelog4net.Layout.PatternLayout conversionPattern value%date [%thread] %-5level %logger - %message%newline / /layout /appender /log4net说明几个关键点file valueLogs/app- /是日志文件前缀datePattern里的yyyyMMdd会拼在文件名后面所以每天会生成app-20250615.log这样的文件。datePattern中的点号.log用单引号包住目的是让点号原样输出否则可能被当成特殊格式处理。这是我实际踩过的坑。staticLogFileName valuefalse /表示活动日志文件名也带日期保证当天文件是唯一的。确保Logs目录存在log4net 不会主动创建多层目录目录不存在时可能会静默失败。2.3 初始化代码的三种写法第一种在程序集上添加特性[assembly: log4net.Config.XmlConfigurator(ConfigFile log4net.config, Watch true)]第二种在入口方法或Application_Start里手动加载log4net.Config.XmlConfigurator.Configure(new FileInfo(log4net.config));第三种直接在程序集特性里不写ConfigFile默认从app.config读取log4net节点。我推荐手动Configure因为它最可控不会出现“配置到底加载了没有”的模糊状态。Watch true虽然能监视配置文件修改后自动重载但生产环境不建议频繁改日志配置触发重载反而影响稳定性。3. Appender 选型、Layout 调参与最佳组合3.1 按场景选 Appender用 log4net 这么多年我总结了一套按场景选择 Appender 的表格可以直接抄需求推荐 Appender说明本地调试ConsoleAppender输出到控制台开发时最直观单文件追加FileAppender日志量小或临时任务按天/按大小滚动RollingFileAppender生产环境首选日志入库分析AdoNetAppender批量写入减少对业务线程的影响错误邮件告警SmtpAppenderERROR 以上级别发邮件内存缓冲BufferingForwardingAppender合并日志事件降低 IO 和锁竞争单元测试断言MemoryAppender在测试代码里检查日志事件SmtpAppender要慎用。邮件通道本身可能阻塞如果 SMTP 服务器响应慢业务线程会被拖住。AdoNetAppender也有类似问题如果数据库挂了业务日志会跟着丢。这两种 Appender 都应该在前期做压测别等生产环境出问题再后悔。3.2 RollingFileAppender 参数细节RollingFileAppender 是生产环境的主角参数配置有几个容易混淆的地方rollingStyleDate表示按日期滚动Size表示按大小滚动Composite同时支持两者。想要“每天一个文件且单个文件不超过 10MB”必须用Composite。maximumFileSize默认 10MB配合maxSizeRollBackups可以控制历史文件数量。appendToFile如果设为false进程重启时会覆盖旧日志这个选项一般保持true。staticLogFileName为true时当前日志文件始终叫同一名字滚动后旧文件改名为false时当前文件名直接带日期或序号。还有锁定模型。默认ExclusiveLock只允许一个进程写同一个文件如果多个进程需要共享日志文件可以改成MinimalLocklockingModel typelog4net.Appender.FileAppenderMinimalLock /但这会让每次写入都经历一次开锁解锁吞吐量明显下降只适合低频场景。我维护过一个定时任务和一个 Web 站点共用日志文件的项目实在避不开才用MinimalLock。3.3 PatternLayout 常用参数表参数含义示例输出%date{ISO8601}时间戳2025-06-15 10:00:00,123%thread线程编号5%-5level左对齐级别INFO%loggerLogger 名称MyApp.Program%message日志消息application started%newline换行换行%exception异常堆栈完整异常信息%property{key}上下文属性自定义值%class和%file这类参数能输出调用类名和文件名但需要加载调试信息会影响性能生产环境不建议加。3.4 同时写文件和控制台的组合开发阶段想同时在控制台看到日志生产环境写文件最简单的方式是在root下挂两个 appender-refroot level valueINFO / appender-ref refConsoleAppender / appender-ref refRollingFileAppender / /root如果不同业务模块要写到不同文件比如订单日志和登录日志分开就需要用logger节点独立配置。这时很多人会遇到“一条日志出现在多个文件”的问题原因是子 Logger 默认继续向父 Logger 的 Appender 输出这就是 additivity。解决办法是在独立配置的logger节点上加logger nameMyApp.Order level valueINFO / appender-ref refOrderFileAppender / additivity valuefalse / /loggeradditivityfalse表示这条日志不再向上级 Logger 的 Appender 传递能有效避免重复写入。4. 高频故障排障日志不落盘、重复输出、滚动失效4.1 日志文件压根没生成这是出现频率最高的问题。排查顺序我基本固定为log4net 配置是写在app.config里还是独立文件里写在app.config但没注册configSections大概率不会加载。有没有真正执行初始化程序集特性是否写在了入口程序集上如果 log4net 是从类库里调用而特性写在另一个程序集初始化时机可能不对。目录权限是否足够Windows 服务默认账户可能没有用户目录写权限IIS 应用池也要给日志目录写权限。配置文件是不是有 XML 格式错误log4net 很多配置错误是静默吞掉的不会抛异常。排查技巧在log4net根节点加debugtruelog4net 会把内部诊断信息输出到调试器或控制台很快能看到配置加载过程中的异常。4.2 一条日志被写进多个文件这个现象通常不是 bug而是 additivity 的默认行为。对additivity的理解不深就会觉得 log4net 疯了。解决思路是检查 Logger 命名层次根节点挂了文件某个业务命名空间又挂了自己的文件那么这个命名空间下的日志就可能出现两份。按前面说的在logger节点加additivity valuefalse /即可。4.3 日志文件不滚动滚动失效有三个高频原因rollingStyle配成Date但datePattern没达到滚动条件。Date模式要跨天才会创建新文件如果只是当天调试看不到滚动是正常的。既想按日期又想按大小滚动却只用Date模式maximumFileSize不会生效。这时候要用Composite。staticLogFileNametrue时滚动文件被改名为带历史后缀的文件你以为没滚动其实旧文件已经被改名了。想让当天文件直接带日期就把staticLogFileName设为false。4.4 日志把磁盘写满日期滚动不等于自动删除旧文件。maxSizeRollBackups在Date模式下并不绝对保证清理逻辑生产环境必须靠运维脚本兜底比如定期清理 N 天前的日志文件。1.2.10 没有内置保留天数策略这是很多新版本也未必解决的问题所以日志清理一定要纳入日常运维检查。4.5 高并发下日志性能下降1.2.10 的 Appender 默认是同步执行的。日志量一旦上去文件锁竞争会变成瓶颈。如果不想改代码可以用BufferingForwardingAppender把日志事件缓冲起来批量转发给真正的输出 Appender。但要注意缓冲意味着应用崩溃时可能丢失最近的一部分日志这个取舍需要业务方来决定。5. 如果要离开 1.2.10升级前需要算清的账5.1 新版 log4net 与 1.2.10 的差异新版 log4net 已经覆盖 .NET Standard 2.0跨平台能力更强。配置文件结构基本兼容但程序集版本和强名称有变化直接替换 dll 可能触发Could not load file or assembly错误通常需要配置 bindingRedirect 才能加载成功。RollingFileAppender 在后续版本中的底层处理也有所调整部分参数的含义更严格。升级后不要想当然地配置一次就完事必须跑一轮测试重点验证日期滚动、文件名后缀和异常堆栈输出。另外要有个预期新版依然没有内置的异步 Appender异步写入要靠自己封装第三方扩展组件不要指望升级就能自动解决性能问题。5.2 我的迁移顺序如果项目还在 .NET Framework且不是完全没有升级空间我建议按下面顺序操作用 NuGet 替换原来的 dll 引用选择一个长期维护的稳定版本例如 log4net 2.0.x 系列。在app.config中确认 bindingRedirect 正确避免运行时加载旧版本程序集。启动时写一条DEBUG、一条INFO、一条ERROR测试日志检查文件生成、滚动和异常堆栈。用日志量压测一下写入吞吐评估要不要加BufferingForwardingAppender。上线前关闭内部诊断日志级别从DEBUG收紧到INFO或WARN。5.3 真正不能升级的项目怎么办有些项目因为 .NET Framework 2.0 限制、老服务器环境或第三方依赖锁死实在无法离开 1.2.10。这种情况下我的建议是别硬升级重点做好运维管理每天确认日志是否正常滚动、目录权限和磁盘空间是否足够、日志级别不要设在DEBUG除非临时抓问题。我维护过的一套老系统至今锁在 1.2.10只要配置不动它跑起来非常省心。最后分享一个我在实际排查中的土办法log4net 这类组件出问题时先别看业务代码先确认日志配置到底有没有被加载。只要看到LogManager.GetRepository().Configured的结果是true再顺着 Appender 往下查基本半小时内能定位。1.2.10 年纪不小但我一直觉得它是那个年代最稳定的日志层之一配置一次能安静跑很多年。本文还有配套的精品资源点击获取