.NET 6 Web API中AddSerilog与UseSerilog的区别及配置疑问

一、builder.Logging.AddSerilog() 和 builder.Host.UseSerilog() 的核心差异 #

• builder.Logging.AddSerilog(Log.Logger)
  这个方法是把Serilog作为一个日志提供程序添加到.NET默认的日志系统集合中。即使你调用了ClearProviders()清空其他提供程序，它依然基于.NET通用日志框架工作——日志请求会先经过.NET的日志管道，再转发给Serilog处理。这种方式适合需要同时使用多个日志提供程序的场景（比如同时输出到Serilog和Debug窗口）。

• builder.Host.UseSerilog(Log.Logger)
  这个方法是直接替换整个日志系统，让Serilog完全接管宿主的日志处理逻辑。它绕过了.NET默认的日志提供程序机制，所有日志请求会直接发送给Serilog，不需要经过中间层。这种方式性能更优，也能更好地支持Serilog的高级特性（比如自定义上下文 enrichment、结构化日志的精细控制），是Serilog官方推荐的集成方式。

二、是否需要同时调用？ #

完全不需要，同时调用反而会导致问题：

• 如果没清空其他日志提供程序，会出现重复日志输出；
• 即使清空了，两种方式的日志管道逻辑重叠，可能引发不必要的资源消耗或潜在冲突。

三、推荐的配置方式 #

方式1：用UseSerilog接管日志系统（推荐）

Log.Logger = new LoggerConfiguration()
        .ReadFrom.Configuration(builder.Configuration)
        .Enrich.FromLogContext()
        .WriteTo.Console()
        .CreateLogger();

// 直接用UseSerilog接管，无需ClearProviders和AddSerilog
builder.Host.UseSerilog(Log.Logger);

方式2：用AddSerilog添加为单一提供程序（仅当需要兼容其他日志逻辑时使用）

Log.Logger = new LoggerConfiguration()
        .ReadFrom.Configuration(builder.Configuration)
        .Enrich.FromLogContext()
        .WriteTo.Console()
        .CreateLogger();

// 清空默认提供程序后添加Serilog
builder.Logging.ClearProviders();
builder.Logging.AddSerilog(Log.Logger);

内容的提问来源于stack exchange，提问作者user246392