如何避免Serilog GZip日志文件因异常关机损坏？

问题根源 #

你的配置没有错误，GZipHooks的设计确实依赖应用有序关机才能保证压缩日志的完整性。原因在于：

• GZipHooks是在文件流外层包装GZipStream实现压缩，而GZip格式要求文件必须包含完整的结束标记才能正常解压。
• 当应用被强制关闭（比如杀进程、断电）时，Log.CloseAndFlush()无法执行，GZipStream的Dispose()方法也不会被调用，导致压缩流没有完成收尾工作，生成的文件缺失必要的压缩元数据，因此解压时会出现invalid compressed data--format violated或unexpected end of file错误。

可行解决方案 #

1. 改用「滚动日志+事后压缩」模式（推荐）

放弃实时压缩，先写入非压缩的滚动日志，待日志文件完成滚动（不再被应用写入）后，再对旧日志进行压缩。这样即使应用异常终止，当前正在写入的日志是未压缩的纯文本，不会损坏；旧日志已经完成滚动，压缩时不会被修改，能保证完整性。

配置示例：

// 先配置普通滚动日志，不带GZipHooks
.WriteTo.File(
  new CompactJsonFormatter(), 
  "/somepath/log/json/main_log_.json",
  rollingInterval: RollingInterval.Month)

压缩实现方式：

• 用后台定时任务（比如ASP.NET Core的IHostedService）定期扫描已滚动完成的日志文件（文件名包含具体月份，而非当前正在写入的文件），使用GZipStream进行压缩后删除原文件。
• 或者用外部工具（Windows任务计划、Linux Cron）定时执行压缩脚本。

2. 调整Serilog的缓冲与刷新策略（降低损坏概率）

通过减少内存缓冲、提高刷新频率，降低异常关机时丢失的数据量，但无法完全避免压缩文件损坏（因为GZip流仍需正常收尾）。

配置示例：

.WriteTo.File(
  new CompactJsonFormatter(), 
  "/somepath/log/json/main_log_.json",
  rollingInterval: RollingInterval.Month, 
  hooks: new GZipHooks(),
  buffered: false, // 关闭缓冲，实时写入
  flushToDiskInterval: TimeSpan.FromSeconds(1)) // 每1秒强制刷新到磁盘

3. 自定义健壮的GZip Hook

重写GZipHooks，结合ASP.NET Core的生命周期事件，捕获进程终止信号，确保GZipStream能被正确关闭。

示例代码：

public class SafeGZipHooks : GZipHooks
{
    private GZipStream? _gzipStream;
    private readonly IHostApplicationLifetime _lifetime;

    public SafeGZipHooks(IHostApplicationLifetime lifetime)
    {
        _lifetime = lifetime;
        _lifetime.ApplicationStopping.Register(CloseGZipStream);
    }

    public override Stream OnFileOpened(Stream underlyingStream, Encoding encoding)
    {
        _gzipStream = new GZipStream(underlyingStream, CompressionLevel.Optimal, leaveOpen: false);
        return _gzipStream;
    }

    private void CloseGZipStream()
    {
        _gzipStream?.Flush();
        _gzipStream?.Close();
    }
}

// 注册Hook时注入IHostApplicationLifetime
.WriteTo.File(
  new CompactJsonFormatter(), 
  "/somepath/log/json/main_log_.json",
  rollingInterval: RollingInterval.Month, 
  hooks: new SafeGZipHooks(app.Services.GetRequiredService<IHostApplicationLifetime>()))

注：此方案仍无法覆盖极端场景（比如直接 kill -9 进程），但能处理大部分正常的强制关闭场景（比如控制台Ctrl+C、应用池回收）。

4. 替换为更健壮的压缩Sink或日志收集方案

• 考虑使用第三方Sink（比如Serilog.Sinks.File.Lz4），部分替代Sink的压缩实现可能更健壮；
• 将日志发送到专业的日志收集系统（比如Seq、ELK Stack），由收集系统负责日志的存储与压缩，应用端只负责发送日志，避免本地压缩带来的损坏问题。

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