.NET 8 Minimal API中Serilog仅在表不存在时写入MySQL问题

可能原因 #

1. 表结构不匹配或sink缓存表结构：Serilog.Sinks.MySQL自动创建表时的字段定义，可能和后续日志输出的字段存在不兼容情况，且sink内部会缓存表结构，导致表存在时写入失败但无报错。
2. 批量写入未触发：配置的batchPostingLimit=100和period=10秒，如果新日志数量未达到批量阈值，且程序未正常触发刷新逻辑，日志会留在内存队列中。
3. 日志级别过滤：配置中可能存在未明确的日志级别限制，导致信息级日志未被写入数据库。
4. sink内部错误未暴露：Serilog.Sinks.MySQL可能吞掉了写入过程中的异常，无法直观看到失败原因。

解决方案 #

1. 开启Serilog内部错误日志排查问题 #

在Program.cs的Serilog初始化前添加SelfLog捕获内部错误，直接定位写入失败原因：

// 在builder.Host.UseSerilog之前添加
Serilog.Debugging.SelfLog.Enable(msg => Console.WriteLine(msg));

运行程序后查看控制台输出，即可获取日志写入失败的具体信息。

2. 手动创建符合要求的日志表 #

放弃自动创建表，手动创建兼容的Logs表结构，避免sink缓存的表结构不匹配问题。示例SQL（适配Serilog.Sinks.MySQL默认字段）：

CREATE TABLE Logs (
    Id INT AUTO_INCREMENT PRIMARY KEY,
    Timestamp DATETIME NOT NULL,
    Level VARCHAR(50) NOT NULL,
    Message TEXT NULL,
    MessageTemplate TEXT NULL,
    Exception TEXT NULL,
    Properties JSON NULL
);

随后将appsettings.json中的autoCreateSqlTable设为false。

3. 调整批量写入配置 #

修改批量参数，降低阈值或缩短周期，确保日志能及时写入：

"Args": {
  "connectionString": "server=myserver;port=3306;Database=mydatabase;uid=username;pwd=password;",
  "tableName": "Logs",
  "autoCreateSqlTable": false,
  "batchPostingLimit": 1,
  "period": "0.00:00:01",
  // 其他参数...
}

同时在程序关闭时强制刷新日志队列：

var app = builder.Build();

// 你的API端点配置...

app.Run();

// 程序退出时刷新日志
Log.CloseAndFlush();

4. 检查日志级别配置 #

确保appsettings.json中没有限制日志级别低于Information：

"Serilog": {
  "MinimumLevel": {
    "Default": "Information",
    "Override": {
      "Microsoft": "Warning",
      "System": "Warning"
    }
  },
  // 其他配置...
}

5. 验证数据库权限 #

确认数据库用户拥有Logs表的INSERT权限，虽然自动创建表说明有CREATE权限，但INSERT权限可能被单独限制。

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