Serilog Destructure.ByTransforming跳过iDB2Parameter类型日志语句问题排查

看起来你遇到的问题是Serilog在尝试解构iDB2Parameter数组时静默跳过了日志，甚至自定义解构器也没生效。这种情况通常和解构时机、属性访问异常、日志级别配置这几个点有关，我给你梳理几个排查和解决的步骤：

1. 先排查基础配置：确保Debug级别日志真的能输出 #

首先要确认你的Serilog配置里没有过滤掉Debug级别：

• 全局配置要加上.MinimumLevel.Debug()
• Elasticsearch Sink也要明确设置MinimumLogEventLevel = LogEventLevel.Debug，不然sink可能会忽略Debug日志

示例配置：

var loggerConfig = new LoggerConfiguration()
    .MinimumLevel.Debug() // 全局开启Debug级别
    // 先注册解构器，再配置输出
    .Destructure.ByTransforming<IBM.Data.DB2.iSeries.iDB2Parameter>(x => new {
        x.ParameterName,
        Type = x.iDB2DbType,
        x.Size,
        // 处理空值，避免Value属性访问异常
        Value = x.Value == DBNull.Value ? "DBNull" : x.Value?.ToString() ?? "null"
    })
    .WriteTo.Elasticsearch(new ElasticsearchSinkOptions(new Uri("http://your-es-endpoint:9200")) {
        MinimumLogEventLevel = LogEventLevel.Debug, // Sink也要开启Debug
        // 其他sink配置...
    });

2. 启用Serilog自我日志，抓解构时的异常 #

Serilog默认会静默跳过有问题的日志事件（比如解构时抛出异常），你可以开启自我日志来查看具体错误：

// 在程序启动时添加
Serilog.Debugging.SelfLog.Enable(message => Console.WriteLine($"Serilog SelfLog: {message}"));

如果解构iDB2Parameter的某个属性（比如Value）时抛出了异常（比如延迟加载、未初始化参数），自我日志会打印出错误信息，这通常是日志被跳过的核心原因。

3. 调整自定义解构器的注册顺序 #

Serilog的配置是顺序执行的，解构器必须在WriteTo之前注册，不然sink拿到日志事件时还没应用解构规则。把.Destructure相关的代码放在所有.WriteTo配置之前，这点很容易被忽略！

4. 先测试单个参数，再扩展到数组 #

先抛开数组，单独测试单个iDB2Parameter的解构：

var testParam = new IBM.Data.DB2.iSeries.iDB2Parameter("@TestID", IBM.Data.DB2.iSeries.iDB2DbType.Integer) { Value = 12345 };
_logger.Debug("单个参数测试: {@Param}", testParam);

如果单个参数能正常输出解构后的内容，那数组的问题大概率是元素解构器生效了，但之前的配置顺序或日志级别有问题；如果单个也不行，那就是解构器本身的问题（比如类型匹配错误、属性访问异常）。

5. 优化自定义解构器，避免潜在异常 #

iDB2Parameter的Value属性可能返回DBNull.Value，或者某些参数未赋值时访问会触发异常，在解构器里做安全处理：

.Destructure.ByTransforming<IBM.Data.DB2.iSeries.iDB2Parameter>(x => new {
    x.ParameterName,
    Type = x.iDB2DbType.ToString(), // 转成字符串更易读
    x.Size,
    Value = x.Value switch {
        DBNull _ => "DBNull",
        null => "null",
        _ => x.Value.ToString()
    }
})

这样能避免因为属性访问异常导致Serilog跳过整个日志事件。

按照这些步骤排查下来，应该能解决日志被跳过的问题，核心是先通过自我日志找到隐藏的异常，再调整配置顺序和解构器的安全性。

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