ASP.NET中UseSerilog/UseNLog与AddSerilog/AddNLog的功能差异及副作用疑问

核心区别 #

• UseSerilog/UseNLog：属于替换式注册，会直接替换ASP.NET默认的ILoggerFactory为对应日志库的实现。多数这类方法默认会清空已注册的其他日志提供程序，让整个日志系统完全切换到目标库的原生管道。
• builder.Logging.AddSerilog/AddNLog：属于追加式注册，是在ASP.NET原生日志系统中新增一个输出渠道。不会替换原有日志工厂，所有已注册的提供程序（包括控制台、Debug等默认项）都会并行处理日志。

功能是否等效？ #

完全不等效：

• 用UseXxx时，日志会直接进入目标日志库的处理流程，ASP.NET原生的日志过滤、级别控制规则可能被覆盖或部分失效（比如Serilog会优先使用自身的配置决定日志是否输出）。
• 用AddXxx时，日志先经过ASP.NET原生管道（应用appsettings.json里的Logging配置、过滤规则），再分发给所有已注册的提供程序，实现多渠道同步输出。

常见副作用 #

1. UseXxx的副作用 #

• 后续UseYyy大概率失效：第一个UseXxx替换日志工厂后，后续的UseYyy通常无法再成功接管日志系统（不同库的实现逻辑有差异，比如Serilog替换后，NLog的UseNLog无法覆盖已替换的工厂）。
• 原生日志配置可能被忽略：部分UseXxx实现会绕过ASP.NET的Logging节点配置，直接使用自身库的专属配置（比如Serilog读取appsettings.json中的Serilog段）。
• 默认日志输出丢失：如果没有特意配置保留，UseXxx会移除控制台、Debug等默认日志提供程序。

2. AddXxx的副作用 #

• 轻微性能损耗：日志需要经过原生管道转发到多个提供程序，多了一层处理环节。
• 配置复杂度提升：需要同时维护ASP.NET原生日志配置和目标库的自身配置（比如既要在Logging中设置级别，又要在Serilog中配置输出模板）。

对你遇到现象的解释 #

你调用UseSerilog后，UseNLog失效但builder.Logging.Add其他提供程序能工作，原因在于：

• UseSerilog替换了日志工厂，但部分实现（比如Serilog）允许通过参数（如writeToProviders: true）将日志转发到原生日志系统的提供程序。你通过builder.Logging.Add添加的提供程序属于原生管道，因此能正常接收日志。
• UseNLog失效是因为它试图替换已被Serilog接管的日志工厂，而多数日志库的UseXxx方法仅能成功替换一次，后续的替换操作会被忽略或无法生效。

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