如何为多应用共享的Serilog滚动日志文件添加表头？

你遇到的报错是Serilog官方文件Sink的设计限制：shared=true 共享写入模式为了避免多进程操作冲突，直接禁用了文件生命周期钩子，所以第三方HeaderWriter依赖的hooks参数无法同时和共享模式生效。

方案1：手动实现表头写入逻辑（改造成本最低） #

不用官方的hooks参数，自己在Serilog初始化前、以及滚动文件生成时处理表头写入，步骤如下：

• 每次初始化Logger前，先判断目标日志文件是否为新建/空文件
• 若文件为空，先以独占模式打开文件写入表头，关闭后再初始化Serilog开启共享写入
• 写入表头时加进程锁，避免多个应用同时写重复表头

示例代码：

// 先处理表头写入
var logPath = "你的日志路径.log";
var header = "Level Timestamp Message MachineName" + Environment.NewLine;
if (!File.Exists(logPath) || new FileInfo(logPath).Length == 0)
{
    // 独占打开写表头，避免多进程重复写
    using (var fs = new FileStream(logPath, FileMode.OpenOrCreate, FileAccess.Write, FileShare.None))
    using (var sw = new StreamWriter(fs))
    {
        if (fs.Length == 0) // 二次判断避免进程竞争时重复写
        {
            sw.Write(header);
            sw.Flush();
        }
    }
}

// 再初始化Serilog，去掉hooks参数
Log.Logger = new LoggerConfiguration()
    .Enrich.FromLogContext()
    .WriteTo.File(logPath, 
        rollOnFileSizeLimit: true, 
        fileSizeLimitBytes:5000, 
        retainedFileCountLimit: null, 
        shared: true, 
        outputTemplate:"{Level} {Timestamp:yyyy-MM-dd HH:mm:ss.fff} {Message} {MachineName}{NewLine}")
    .CreateLogger();

如果需要滚动后的新文件也自动加表头，可以额外加一个简单的日志拦截逻辑，每次写日志前校验当前滚动文件的大小，发现新生成的空文件就先写入表头。

方案2：改用聚合模式写公共日志 #

如果怕多进程操作冲突，可以放弃多进程直接写同个文件：

• 每个应用单独写自己的临时日志，正常带表头、按大小切分
• 单独启动一个后台服务，定时把所有应用的临时日志合并到公共日志文件中，合并时统一处理表头和切分规则，完全避免多进程写入冲突。

方案3：自定义适配共享模式的Header钩子 #

如果不想改现有逻辑，可以自行实现日志钩子，跳过官方Sink对共享模式下钩子的禁用检查，写入表头前先判断文件是否为空，用原子写入操作避免重复写表头。

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