C# Log4Net 学习笔记：将日志实时记录到数据库

在 C/S 架构的项目中，本地文件日志（.txt）虽然方便查看，但难以进行统计分析。通过 Log4Net 的 ADONetAppender，我们可以将异常信息和运行日志直接写入 SQL Server，便于后续通过 SQL 语句快速排查问题。

一、数据准备：创建日志表#

首先，我们需要在 SQL Server 中准备一张承载日志的表。由于日志数据增长极快，建议为 LogDate 字段建立索引。

1
CREATE TABLE [dbo].[LogDetail](
2
    [LogID] [INT] IDENTITY(1,1) NOT NULL,
3
    [LogDate] [DATETIME] NOT NULL,   -- 日志记录时间
4
    [LogThread] [VARCHAR](50) NULL,  -- 线程 ID
5
    [LogLevel] [VARCHAR](50) NULL,   -- 日志级别 (INFO/ERROR等)
6
    [Logger] [VARCHAR](255) NULL,    -- 记录器名称
7
    [LogMessage] [NVARCHAR](MAX) NULL, -- 日志详细内容
8
    CONSTRAINT [PK_LogDetail] PRIMARY KEY CLUSTERED ([LogID] ASC)
9
) ON [PRIMARY];

二、 Log4Net 核心配置解析#

Log4Net 的强大之处在于其插件式架构。ADONetAppender 负责将 LoggingEvent 转化为数据库的一条记录。

2.1 配置文件 (ConfigFile/Log4NetToDB.config)#

关键参数说明：

bufferSize: 设置为 0 表示即时写入。在生产高并发环境下，建议设为 10-100 以减轻数据库压力（利用批处理）。
connectionType: 需指向对应的数据库驱动程序。

1
<?xml version="1.0" encoding="utf-8" ?>
2
<log4net>
3
  <appender name="ADONetAppender" type="log4net.Appender.ADONetAppender">
4
    <bufferSize value="0" /> <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
5
    <connectionString value="Data Source=.;Initial Catalog=TestDB;User ID=sa;Password=********;" />
6

7
    <commandText value="INSERT INTO LogDetail (LogDate, LogLevel, LogThread, Logger, LogMessage)
8
                        VALUES (@LogDate, @LogLevel, @LogThread, @Logger, @LogMessage)" />
9

10
    <parameter>
11
      <parameterName value="@LogDate" />
12
      <dbType value="DateTime" />
13
      <layout type="log4net.Layout.RawTimeStampLayout" />
14
    </parameter>
15

16
    <parameter>
17
      <parameterName value="@LogMessage" />
18
      <dbType value="String" />
19
      <size value="4000" />
20
      <layout type="log4net.Layout.PatternLayout">
21
        <conversionPattern value="%message" />
22
      </layout>
23
    </parameter>
24

25
    </appender>
26

27
  <root>
28
    <level value="ALL" />
29
    <appender-ref ref="ADONetAppender" />
30
  </root>
31
</log4net>

三、高级进阶：自定义日志内容处理#

有时我们需要记录的不止是一个简单的字符串，而是一个复杂的对象。通过重写 PatternLayoutConverter，我们可以动态地从对象属性中提取值。

3.1 核心逻辑实现#

CustomLayoutConverter.cs 负责反射提取自定义对象中的属性：

1
protected override void Convert(TextWriter writer, LoggingEvent loggingEvent)
2
{
3
    if (Option != null)
4
    {
5
        // 反射提取 LogContent.LogMessage
6
        var propertyInfo = loggingEvent.MessageObject.GetType().GetProperty(Option);
7
        var value = propertyInfo?.GetValue(loggingEvent.MessageObject, null);
8
        WriteObject(writer, loggingEvent.Repository, value);
9
    }
10
}

四、性能与避坑建议#

异步写入：数据库写入是 IO 密集型操作。在高吞吐系统中，建议在外层嵌套一个 AsyncForwardingAppender（来自 log4net.Async 库），避免写日志阻塞业务线程。
数据库连接安全：不要在配置文件中明文存储密码。可以使用宝塔面板的加密功能或 .NET 自带的 configProtectionProvider。
表维护计划：日志表会迅速膨胀。建议建立 SQL 代理作业，定期清理（如仅保留 30 天）或归档旧日志：

1
DELETE FROM LogDetail WHERE LogDate < DATEADD(day, -30, GETDATE());

总结#

通过 Log4Net 记录日志到数据库，可以将离散的错误信息转化为有价值的资产。配合简单的 Grafana 或是自定义的后台界面，你就能实时监控系统的健康状况。

一、 数据准备：创建日志表#