升级Serilog至2.*后日志功能失效的技术求助

核心问题分析 #

日志失效的根源是Serilog 2.x版本对配置格式和Sink组件做了重大调整：原RollingFile Sink已被合并到File Sink中，旧配置无法被新版本识别，且Serilog默认会静默忽略配置加载错误，导致无日志输出也无异常抛出。

具体修复步骤 #

1. 替换旧RollingFile配置为新File Sink格式 #

Serilog 2.x起，Serilog.Sinks.RollingFile已被废弃，滚动日志功能整合到Serilog.Sinks.File中。需修改appSettings中的滚动日志配置：

原无效配置：

<add key="serilog:write-to:RollingFile" value="Serilog.RollingFileSink" />
<add key="serilog:write-to:RollingFile.restrictedToMinimumLevel" value="Information" />
<add key="serilog:write-to:RollingFile.pathFormat" value="C:\Logs\Service-{Date}.log" />
<add key="serilog:write-to:RollingFile.retainedFileCountLimit" value="10" />

修改后有效配置：

<!-- 移除原RollingFile的类型指定行 -->
<add key="serilog:write-to:File.restrictedToMinimumLevel" value="Information" />
<add key="serilog:write-to:File.pathFormat" value="C:\Logs\Service-{Date}.log" />
<add key="serilog:write-to:File.retainedFileCountLimit" value="10" />
<!-- 可选：明确滚动间隔，默认按天滚动 -->
<add key="serilog:write-to:File.rollingInterval" value="Day" />

2. 修正Trace Sink配置 #

原Trace Sink的类型指定行无需保留，Serilog会自动识别已安装的Serilog.Sinks.Trace包，删除以下无效配置行：

<add key="serilog:write-to:Trace" value="Serilog.Trace" />

修改后Trace配置仅保留：

<add key="serilog:write-to:Trace.restrictedToMinimumLevel" value="Debug" />

3. 开启Serilog自我诊断排查隐藏错误 #

添加自我诊断代码可输出Serilog内部加载错误，帮助定位问题：

// 在日志初始化前添加
Serilog.Debugging.SelfLog.Enable(msg => 
{
    Console.WriteLine(msg);
    // 同时写入临时文件留存日志
    System.IO.File.AppendAllText(@"C:\Logs\serilog-selflog.txt", msg + Environment.NewLine);
});

// 原初始化代码
Log.Logger = new LoggerConfiguration()
    .Enrich.WithExceptionDetails()
    .ReadFrom.AppSettings()
    .CreateLogger();
Log.Information("Service Starting");

4. 验证包依赖兼容性 #

确保已安装的包版本匹配：

• Serilog.Settings.AppSettings 2.2.2 兼容Serilog 2.11.0
• Serilog.Sinks.File 5.0.0 支持滚动日志功能
• 若之前安装过Serilog.Sinks.RollingFile，需卸载该包

完整修改后的appSettings示例 #

<appSettings>
    <!--Serilog-->
    <add key="serilog:minimum-level" value="Debug" />
    <!--trace logging-->
    <add key="serilog:write-to:Trace.restrictedToMinimumLevel" value="Debug" />
    <!--rolling file logging（使用新版File Sink）-->
    <add key="serilog:write-to:File.restrictedToMinimumLevel" value="Information" />
    <add key="serilog:write-to:File.pathFormat" value="C:\Logs\Service-{Date}.log" />
    <add key="serilog:write-to:File.retainedFileCountLimit" value="10" />
    <add key="serilog:write-to:File.rollingInterval" value="Day" />
</appSettings>

验证效果 #

修改配置并添加自我诊断后重新运行应用：

• 配置加载正常时，会生成指定路径的滚动日志文件
• 若仍有问题，查看serilog-selflog.txt中的错误信息（如权限不足、参数格式错误等）

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