自定义Serilog Sink通过AppSettings配置无法正常工作求助

看起来你遇到的问题是：自定义Serilog Sink用代码直接配置（WriteTo.LogSenderSink()）能正常工作，但通过ReadFrom.AppSettings()读取配置文件时就失效——我之前也碰到过类似情况，通常是配置文件格式不对，或者Serilog找不到你的自定义Sink程序集导致的，下面给你一步步排查的解决方案：

第一步：检查AppSettings的配置格式 #

Serilog读取AppSettings时，不能只写Sink的方法名，必须明确指定程序集引用和Sink的完整配置项。你的配置文件应该改成类似这样：

<appSettings>
  <!-- 引用自定义Sink所在的程序集 -->
  <add key="serilog:using:LogSender" value="YourAssemblyName" />
  <!-- 指定要使用的自定义Sink -->
  <add key="serilog:write-to:LogSenderSink" />
  
  <!-- 如果你的Sink需要参数，要添加对应配置项，比如：
  <add key="serilog:write-to:LogSenderSink.MinimumLevel" value="Information" />
  -->
</appSettings>

这里有两个关键要点：

• serilog:using:XXX：XXX是自定义别名，value填你的Sink所在的程序集名称（不是命名空间，可右键项目→属性→应用程序→程序集名称查看），Serilog靠这个加载包含Sink的程序集。
• serilog:write-to:LogSenderSink：这里的名称必须和你扩展方法里的WriteTo.LogSenderSink()方法名完全一致。

第二步：确认扩展方法的正确性 #

你的扩展方法必须是LoggerConfiguration的静态扩展方法，结构要像这样：

using Serilog;
using Serilog.Configuration;

namespace YourNamespace
{
    public static class LogSenderSinkExtensions
    {
        public static LoggerConfiguration LogSenderSink(
            this LoggerConfiguration loggerConfiguration,
            LogEventLevel restrictedToMinimumLevel = LogEventLevel.Information)
        {
            // 实例化你的Sink并返回配置
            return loggerConfiguration.WriteTo.Sink(new LogSenderSink(), restrictedToMinimumLevel);
        }
    }
}

要确保：

• 类是public static的
• 方法是public static的
• 第一个参数带this关键字，类型是LoggerConfiguration

第三步：验证自定义Sink的实现 #

你的Sink类必须是public的，并且正确实现ILogEventSink接口：

using Serilog.Core;
using Serilog.Events;

namespace YourNamespace
{
    public class LogSenderSink : ILogEventSink
    {
        public void Emit(LogEvent logEvent)
        {
            // 这里写你的日志处理逻辑
        }
    }
}

如果Sink有带参数的构造函数，一定要在AppSettings里对应配置参数，比如Sink构造函数需要string apiUrl，配置就要加：

<add key="serilog:write-to:LogSenderSink.apiUrl" value="https://your-log-api.com" />

第四步：排查程序集加载问题 #

如果配置格式都对但还是不生效，可能是Serilog找不到你的Sink程序集：

• 确认包含Sink的程序集已经被项目正确引用，并且输出目录里有该程序集的dll文件。
• 检查serilog:using里的程序集名称是否和实际一致（注意区分大小写）。

最后：开启自我诊断日志排查 #

如果还是找不到问题，可以开启Serilog的自我诊断日志，它会输出加载配置时的错误信息（比如找不到类型、程序集加载失败等）：

// 在初始化Log.Logger之前添加
Serilog.Debugging.SelfLog.Enable(msg => Console.WriteLine(msg));

配置完成后，用一句简单的日志测试：

Log.Information("测试自定义Sink日志");
Log.CloseAndFlush();

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