.NET Core引入Microsoft.Windows.Compatibility NuGet引发EventLog初始化错误

核心原因 #

引入Microsoft.Windows.Compatibility包后，它包含的System.Diagnostics.EventLog会覆盖ASP.NET Core默认日志组件的逻辑，导致程序尝试使用Windows原生的EventLog实现（该实现与ASP.NET Core跨平台特性不兼容），而非Microsoft.Extensions.Logging.EventLog提供的适配版本。

解决方案 #

1. 显式指定使用ASP.NET Core兼容的EventLog提供者 #

在依赖注入配置中，明确添加Microsoft.Extensions.Logging.EventLog并清理默认可能引入的冲突日志组件：

var builder = WebApplication.CreateBuilder(args);

// 清除所有默认日志提供者，避免冲突
builder.Logging.ClearProviders();
// 按需添加控制台日志（可选）
builder.Logging.AddConsole();
// 显式添加适配ASP.NET Core的EventLog日志提供者
builder.Logging.AddEventLog(options =>
{
    options.LogName = "YourAppLog";
    options.SourceName = "YourAppSource";
});

// 其他服务配置逻辑
var app = builder.Build();

2. 排除Microsoft.Windows.Compatibility中的System.Diagnostics.EventLog #

如果仅需要该包中的System.Management组件，可在项目文件（.csproj）中明确排除System.Diagnostics.EventLog依赖：

<PackageReference Include="Microsoft.Windows.Compatibility" Version="x.x.x">
  <Exclude>System.Diagnostics.EventLog</Exclude>
</PackageReference>

将x.x.x替换为你实际使用的包版本。

3. 条件化加载Windows兼容性组件 #

若项目需要跨平台运行，可通过条件编译或运行时检测，仅在Windows环境下启用Microsoft.Windows.Compatibility相关功能：

#if WINDOWS
// 仅在Windows平台初始化System.Management逻辑
var managementScope = new ManagementScope("\\\\.\\root\\cimv2");
managementScope.Connect();
// 其他System.Management操作
#endif

同时在项目文件中添加条件化包引用：

<PackageReference Include="Microsoft.Windows.Compatibility" Version="x.x.x" Condition="'$(TargetFramework)' == 'net6.0-windows' Or '$(TargetFramework)' == 'net7.0-windows'"/>

验证方式 #

启动应用后，确认不再抛出System.PlatformNotSupportedException，同时可通过Windows事件查看器检查日志是否正常写入指定的事件日志。

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