C#.NET log4net 实战：从基础配置到企业级日志架构
1. 为什么你的.NET项目需要log4net？
第一次接触log4net是在2013年接手一个电商系统重构项目时。当时系统每天产生超过50GB的日志文件，开发团队却还在用原始的Debug.WriteLine输出日志，导致排查线上问题像大海捞针。直到引入log4net后，我们才真正实现了日志的规范化管理。
log4net作为Apache基金会的开源项目，源自Java生态的log4j，经过多年迭代已成为.NET平台最成熟的日志框架。它最吸引我的特点是分层日志架构设计——就像洋葱一样，你可以一层层剥开日志的细节。比如在开发环境记录DEBUG级别日志，在生产环境只保留ERROR以上日志，这种灵活性对多环境支持特别友好。
与.NET内置的TraceSource或ILogger相比，log4net在以下场景优势明显：
- 高并发场景：异步日志和缓冲机制能有效降低I/O阻塞
- 复杂系统：通过Logger层次结构可以实现不同模块的差异化日志策略
- 生产环境：日志自动归档、邮件报警等企业级功能开箱即用
最近帮一个金融客户做系统优化时，我们用log4net的AdoNetAppender将日志直接写入SQL Server，配合存储过程实现了实时交易监控。当异常交易发生时，系统能在500ms内触发风控规则，这充分体现了log4net在企业级应用中的价值。
2. 5分钟快速搭建日志系统
2.1 基础环境配置
先通过NuGet安装log4net包：
dotnet add package log4net我习惯使用独立的log4net.config文件，这样修改配置时不需要重新编译项目。创建一个最小化配置示例：
<?xml version="1.0" encoding="utf-8"?> <log4net> <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender"> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/> </layout> </appender> <root> <level value="DEBUG"/> <appender-ref ref="ConsoleAppender"/> </root> </log4net>在程序启动时加载配置（ASP.NET Core略有不同）：
[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config", Watch = true)] class Program { private static readonly ILog log = LogManager.GetLogger(typeof(Program)); static void Main() { log.Info("系统启动完成"); try { // 业务代码 } catch (Exception ex) { log.Error("主流程异常", ex); } } }2.2 日志记录最佳实践
很多新手会犯的典型错误是字符串拼接：
// 不推荐：即使不记录也会执行字符串拼接 log.Debug("用户ID:" + userId + " 操作:" + action); // 推荐写法1：使用Format方法 log.DebugFormat("用户ID:{0} 操作:{1}", userId, action); // 推荐写法2：使用Lambda延迟计算 log.Debug(() => $"用户ID:{userId} 操作:{action}");对于异常日志，一定要传递异常对象本身：
try { // 可能出错的代码 } catch (DbException ex) { // 错误示例：丢失堆栈信息 log.Error("数据库操作失败"); // 正确做法 log.Error("数据库操作失败", ex); }3. 构建企业级日志架构
3.1 多Appender组合策略
在实际项目中，我通常会配置三种类型的Appender：
- 调试用ConsoleAppender：开发环境使用彩色输出
- 运营日志RollingFileAppender：按日期分割的完整日志
- 错误日志AdoNetAppender：将ERROR以上日志存入数据库
配置示例：
<appender name="ErrorDBAppender" type="log4net.Appender.AdoNetAppender"> <bufferSize value="10"/> <connectionType value="System.Data.SqlClient.SqlConnection"/> <connectionString value="Server=.;Database=LogDB;Integrated Security=true"/> <commandText value="INSERT INTO ErrorLogs(LogDate,Level,Logger,Message,Exception) VALUES (@log_date, @log_level, @logger, @message, @exception)"/> <!-- 参数配置省略 --> </appender> <appender name="BufferedFileAppender" type="log4net.Appender.BufferingForwardingAppender"> <bufferSize value="100"/> <appender-ref ref="RollingFileAppender"/> </appender> <root> <level value="INFO"/> <appender-ref ref="BufferedFileAppender"/> <appender-ref ref="ErrorDBAppender"/> </root>3.2 日志分级过滤技巧
通过Filter可以实现精细控制，比如将不同级别日志写入不同文件：
<appender name="WarnAppender" type="log4net.Appender.FileAppender"> <file value="warnings.log"/> <filter type="log4net.Filter.LevelRangeFilter"> <levelMin value="WARN"/> <levelMax value="WARN"/> </filter> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%date %logger %message%newline"/> </layout> </appender>对于微服务架构，我推荐采用这样的Logger命名规范：
<logger name="ServiceA.Api"> <level value="DEBUG"/> </logger> <logger name="ServiceB.Domain"> <level value="INFO"/> </logger>4. 高性能日志实践
4.1 异步日志优化
在高并发场景下，同步写日志可能成为性能瓶颈。这是我在一个日均千万PV的网站中使用的异步配置：
<appender name="AsyncFileAppender" type="log4net.Appender.AsyncAppender"> <appender-ref ref="RollingFileAppender"/> </appender> <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender"> <file value="logs/app.log"/> <rollingStyle value="Composite"/> <maxSizeRollBackups value="50"/> <maximumFileSize value="100MB"/> <staticLogFileName value="true"/> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/> </layout> </appender>实测表明，异步模式可以将日志写入耗时从15ms降低到2ms以内。但要注意缓冲区大小设置，避免应用崩溃时丢失重要日志。
4.2 上下文信息增强
通过ThreadContext可以自动附加请求信息：
// 在ASP.NET Core中间件中 app.Use(async (context, next) => { log4net.ThreadContext.Properties["RequestId"] = context.TraceIdentifier; log4net.ThreadContext.Properties["UserAgent"] = context.Request.Headers["User-Agent"]; await next(); });然后在PatternLayout中使用这些属性：
<conversionPattern value="%date [%thread] [%property{RequestId}] %-5level %logger - %message%newline"/>5. 与现代化技术栈集成
5.1 ASP.NET Core集成方案
在Startup.cs中的标准集成方式：
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureLogging((hostingContext, logging) => { logging.AddLog4Net("log4net.config"); }) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });对于需要结构化日志的场景，可以结合log4net.Ext.Json：
<appender name="ElasticsearchAppender" type="log4net.ElasticSearch.ElasticSearchAppender"> <connectionString value="Server=http://localhost:9200;Index=applogs"/> <layout type="log4net.Layout.SerializedLayout, log4net.Ext.Json"> <member value="date:%date"/> <member value="level:%level"/> <member value="message:%message"/> <member value="exception:%exception"/> </layout> </appender>5.2 容器化部署注意事项
在Docker环境中，需要特别注意：
- 日志文件要挂载到Volume
- 时区问题可能导致日志文件名不准确
- 内存限制可能影响缓冲性能
建议的Dockerfile配置：
FROM mcr.microsoft.com/dotnet/aspnet:6.0 COPY ./publish /app COPY ./config/log4net.docker.config /app/log4net.config WORKDIR /app VOLUME /app/logs ENV TZ=Asia/Shanghai ENTRYPOINT ["dotnet", "YourApp.dll"]6. 日志治理与故障排查
6.1 日志分析策略
我常用的日志分析组合：
- ELK Stack：用于全文搜索和可视化
- Grafana：监控错误率等指标
- 自定义脚本：提取特定业务数据
log4net与Elasticsearch集成的关键配置：
<appender name="ElasticsearchAppender" type="log4net.ElasticSearch.ElasticSearchAppender"> <connectionString value="Server=http://es-server:9200;Index=app-{0:yyyy.MM.dd}"/> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%date|%level|%logger|%message|%exception"/> </layout> </appender>6.2 常见问题排查
最近处理的一个典型问题：日志文件突然停止写入。排查步骤：
- 检查磁盘空间（df -h）
- 确认文件权限（ls -l）
- 查看进程文件句柄（lsof -p PID）
- 检查log4net内部状态（LogManager.GetRepository().Configured）
最终发现是日志文件被其他进程锁定，通过修改配置解决：
<appender name="FileAppender" type="log4net.Appender.FileAppender"> <file value="logs/app.log"/> <lockingModel type="log4net.Appender.FileAppender+MinimalLock"/> <!-- 其他配置 --> </appender>在微服务架构下，建议为每个服务实例配置独立的日志文件：
<file value="logs/${COMPUTERNAME}-app.log"/>