.NET日志框架核心原理与实战实现

1. .NET日志框架核心原理剖析

日志系统是任何应用程序不可或缺的组成部分，特别是在分布式系统和微服务架构中。.NET提供的日志框架通过统一的抽象接口，允许开发者以一致的方式记录日志，同时保持与具体实现的解耦。

1.1 ILogger接口体系

ILogger接口是.NET日志系统的核心抽象，定义在Microsoft.Extensions.Logging.Abstractions包中。其核心方法包括：

csharp复制void Log<TState>(LogLevel logLevel, EventId eventId, TState state, 
                Exception exception, Func<TState, Exception, string> formatter)

关键设计特点：

• 日志级别：Trace(0)到Critical(5)的六级体系
• 结构化日志：支持参数化消息模板（如User {UserId} logged in）
• 事件ID：通过EventId关联特定业务事件
• 异常记录：原生支持异常对象记录

1.2 日志提供程序(Provider)机制

日志框架采用提供程序模式，内置多种实现：

• ConsoleProvider：控制台输出
• DebugProvider：调试窗口输出
• EventSourceProvider：ETW事件跟踪
• AzureAppServices：Azure环境集成

自定义提供程序需实现ILoggerProvider接口，典型实现模式：

csharp复制public class CustomLoggerProvider : ILoggerProvider
{
    public ILogger CreateLogger(string categoryName) => new CustomLogger();
    
    public void Dispose() { /* 资源清理 */ }
}

public class CustomLogger : ILogger
{
    public IDisposable BeginScope<TState>(TState state) => null;
    
    public bool IsEnabled(LogLevel logLevel) => true;
    
    public void Log<TState>(/* 参数 */) { /* 实现 */ }
}

2. 手写简易日志框架实战

2.1 基础架构设计

我们实现一个支持控制台和文件输出的简易框架：

csharp复制// 核心接口
public interface ILogWriter
{
    void Write(LogEntry entry);
}

// 日志实体
public record LogEntry(
    DateTimeOffset Timestamp,
    LogL