自包含单文件裁剪应用中Serilog.Sinks.EventLog初始化失败求助

问题根源 #

.NET的裁剪工具（Trimmer）启用PublishTrimmed时，会移除未被直接静态引用的元数据——包括方法的参数名称信息。Serilog配置系统依赖参数名称匹配WriteTo.EventLog()扩展方法的重载，当这些参数名称元数据被裁剪后，配置系统无法将appsettings.json中传入的source、logName、manageEventSource等参数与对应方法重载关联，因此出现找不到匹配方法的错误。

解决方案 #

需要调整裁剪配置，强制保留Serilog.Sinks.EventLog中相关扩展方法的参数元数据，具体有两种实现方式：

方式1：更新TrimmerRoots.xml配置

修改TrimmerRoots.xml，明确指定保留LoggerConfigurationEventLogExtensions类的所有元数据：

<?xml version="1.0" encoding="utf-8" ?>
<linker>
  <assembly fullname="Serilog" />
  <assembly fullname="Serilog.Settings.Configuration" />
  <assembly fullname="Serilog.Sinks.Console" />
  <assembly fullname="Serilog.Sinks.EventLog">
    <type fullname="Serilog.LoggerConfigurationEventLogExtensions" preserve="all" />
  </assembly>
</linker>

方式2：通过.csproj直接配置裁剪规则

在项目.csproj文件中添加以下配置，让裁剪工具完整保留Serilog.Sinks.EventLog程序集的元数据：

<PropertyGroup>
  <!-- 采用partial裁剪模式，保留更多关键元数据 -->
  <TrimMode>partial</TrimMode>
</PropertyGroup>

<ItemGroup>
  <TrimmerRootAssembly Include="Serilog.Sinks.EventLog" />
</ItemGroup>

验证步骤 #

1. 保存修改后的配置文件
2. 重新执行发布命令：dotnet publish -c Release
3. 运行生成的单文件程序，测试EventLog日志配置是否正常工作
4. 检查Serilog自日志是否再无“找不到EventLog方法”的错误

补充说明 #

Console接收器能正常工作，是因为它的扩展方法重载较少，配置系统无需依赖参数名称即可匹配到对应方法；而EventLog接收器的扩展方法重载更多，必须依赖参数名称才能正确匹配，因此在裁剪后出现问题。

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